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在 实际 的 应 用 中 ，SQLite 作 为 目前 最 为 流行 的 开源 谋 入 式 关系 型 数据 库 ， 在 系统 的 架构 设计 
中 正在 扮演 着 越 来 越 为 重要 的 角色 。 和 很 多 其 它 诬 入 式 NoSQL 数 据 库 不 同 的 是 ，SQLite 支 持 
很 多 关系 型 数据 库 的 基本 特征 ， 这 在 数据 移植 、 程 序 演示 等 应 用 中 有 着 不 可 替代 的 优势 。 从 
官方 文档 中 我 们 可 以 获悉 到 ，SQLite 支 持 的 数据 量 和 运行 效率 都 是 非常 骄 人 的 ， 因 此 在 海量 
数据 的 解决 方案 中 ，SQLite 可 以 作为 数据 预计 算 的 桥头 堡 ， 从 而 显著 减少 存储 在 关系 型 数据 
库 服务 器 中 的 数据 数量 ， 最 终 提高 系统 的 查询 效率 和 运行 期 效率 ， 同 时 也 可 以 显著 的 降低 数 
据 备 份 的 磁盘 开销 。 这 里 提供 了 该 系列 博文 的 目录 ， 以 方便 网 友和 我 个 人 的 学 习 与 参阅 。 


Finally, if you are interseting in my series blogs, please pay more attention on my following 
ones, such as Redis, MongoDB, Lua and PostgreSQL. Thank you for your reading and 
comments, that will give me more effective encouragement and stimulate me to move ahead 
with stable and continuous. 
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如 果 您 觉得 这 个 系列 的 博客 可 以 让 您 有 所 收获 ， 请 保持 持续 的 关注 。 
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如 果 您 有 意 进 行 技 术 上 的 交流 ， 可 以 通过 邮件 共同 探讨 (stephenland74@hotmail.com)。 
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如 果 您 已 经 是 我 的 关注 者 ， 希 望 随后 发 布 的 Redis 系 列 不 会 让 您 失望 。 


| am Stephen Liu. 
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一 、 简 介 : 


SQLite 是 目前 最 流行 的 开源 诅 入 式 数 据 库 ， 和 很 多 其 他 诅 入 式 存储 引擎 相 比 (NoSQL)， 如 
BerkeleyDB、MemBASE 等 ，SQLite 可 以 很 好 的 支持 关系 型 数据 库 所 具备 的 一 些 基 本 特征 ， 
如 标准 SQL 语法 、 事 务 、 数 据 表 和 索引 等 。 事 实 上 ， 尽 管 SQLite 拥 有 诸多 关系 型 数据 库 的 基 
本 特征 ， 然 而 由 于 应 用 场景 的 不 同 ， 它们 之 间 并 没有 更 多 的 可 比 性 。 下 面 我 们 将 列举 一 下 
SQLite 的 主要 特征 : 


1. 管理 简单 ， 甚 至 可 以 认为 无 需 管理 。 

2). 操作 方便 ，SQLite 生 成 的 数据 库 文 件 可 以 在 各 个 平台 无 缝 移植 。 

3). 可 以 非常 方便 的 以 多 种 形式 虞 入 到 其 他 应 用 程序 中 ， 如 静态 库 、 动 态 库 等 。 
4). 多 于 维护 。 


综 上 所 述 ，SQLite 的 主要 优势 在 于 灵巧 、 快 速 和 可 靠 性 高 。SQLite 的 设计 者 们 为 了 达到 这 一 
目标 ， 在 功能 上 作出 了 很 多 关键 性 的 取 含 ， 与 此 同时 ， 也 失去 了 一 些 对 RDBMS 关 键 性 功能 的 
支持 ， 如 高 并 发 、 细 粒度 访问 控制 (如 行 级 锁 )、 丰 富 的 内 置 函 数 、 存 储 过 程 和 复杂 的 SQL 语句 
等 。 正 是 因为 这 些 功能 的 牺牲 才 换 来 了 简单 ， 而 简单 又 换 来 了 高 效 性 和 高 可 靠 性 。 


二 、SQLite 的 主要 优点 : 
1. 一 致 性 的 文件 格式 : 


在 SQLite 的 官方 文档 中 是 这 样 解释 的 ， 我 们 不 要 将 SQLite 与 Oracle 或 PostgreSQL 去 比较 ， 
是 应 该 将 它 看 做 fopen 和 fwrite。 与 我 们 自 定义 格式 的 数据 文件 相 比 ，SQLite 不 仅 提 供 了 Ps 
的 移植 性 ， 如 大 端 小 端 、32/64 位 等 平台 相关 问题 ， 而 且 还 提供 了 数据 访问 的 高 效 性 ， 如 基于 
某 些 信息 建立 索引 ， 从 而 提高 访问 或 排序 该 类 数据 的 性 能 ，SQLite 提 供 的 事务 功能 ， 也 是 在 
操作 普通 文件 时 无 法 有 效 保证 的 。 


2. E AAA AU ES bMS: 

由 于 SQLite 在 运行 时 占用 的 资源 较 少 ， 而 且 无 需 任 何 管理 开销 ， 因 此 对 于 PDA、 物 能 手机 等 
移动 设备 来 说 ，SQLite 的 优势 好 良 置疑 。 

3. 内 部 数据 库 : 


在 有 些 应 用 场景 中 ， 我 们 需要 为 插入 到 数据 库 服务 器 中 的 数据 进行 数据 过 滤 或 数据 清理 ， 以 
保证 最 终 插 入 到 数据 库 服务 器 中 的 数据 有 效 性 。 有 的 时 候 ， 数 据 是 否 有 效 ， 不 能 通过 单一 一 
条 记录 来 进行 判断 ， 而 是 MMC dan d 再 通过 计算 的 

结果 判断 当前 的 数据 是 否 合法 。 在 这 种 应 用 中 ， 我 们 可 以 用 SQLite 缓 冲 这 部 分 历史 数据 。 还 
有 一 种 简单 的 场景 也 适 S eoe ， 即 统计 数据 的 预计 算 。 比 如 我 们 正在 运行 数据 实时 采集 


的 服务 程序 ， 我 们 可 能 需要 将 每 10 秒 的 数据 汇总 后 ， 形 成 每 小 时 的 统计 数据 ， 该 统计 数据 可 
Du 2 Ei iu T 在 这 种 应 用 中 ， 我 
们 可 以 将 1 小 时 内 的 采集 数据 均 缓 存在 SQLite 中 ， 在 达到 整 点 时 ， 计 算 缓存 数据 后 清空 该 数 
据 。 


4. 数据 分 析 : 


可 以 充分 利用 SQLite 提 供 SQL 特 征 ， 完 成 简单 的 数据 统计 分 析 的 功能 。 这 一 点 是 CSV 文 件 无 
法 比拟 的 。 


5. 产品 Demo 和 测试 : 


在 需要 给 客户 进行 Demo 时 ， 可 以 使 用 SQLite 作 为 我 们 和 其 他 关系 型 数据 库 相 
比 ， 使 用 SQLite 减 少 了 大 量 的 系统 部 署 时 间 。 对 于 产品 的 功能 性 测试 而 言 ，SQLite 也 可 以 起 
到 相同 的 作用 。 


、 和 RDBMS 相 比 SQLite 的 一 些 劣 势 : 
1. C/S 应 用 : 


如 果 你 有 多 个 客户 端 需要 同时 访问 数据 库 中 的 数据 ， 特 别 是 他 们 之 间 的 数据 操作 是 需要 通过 
网 络 传输 来 完成 的 。 在 这 种 情况 下 ， 不 应 该 选择 SQLite。 由 于 SQLite 的 数据 管理 机 制 更 多 的 
依赖 于 OS 的 文件 系统 ， 因 此 在 这 种 操作 下 其 效率 较 低 。 


2. 数据 量 较 大 


受 限于 操作 系统 的 文件 系统 ， 在 处 理 大 数据 量 时 ， 其 效率 较 低 。 对 于 超大 数据 量 的 存储 ， 其 
至 不 能 提供 支持 。 


3. 高 并 发 : 


由 于 SQLite 仅 仅 提 供 了 粒度 很 粗 的 数据 锁 ， 如 读 写 锁 ， 因 此 在 每 次 加 锁 操 作 中 都 会 有 大 量 的 
数据 被 锁 住 ， 即 使 仅 有 极 小 部 分 的 数据 会 被 访问 。 换 和 句 话说 ， 我 们 可 以 认为 SQLite 只 是 提供 
了 表 级 锁 ， 没 有 提供 行 级 锁 。 在 这 种 同步 机 制 下 ， 并 发 性 能 很 难 高 效 。 


、 个 性 化 特征 : 


配置 : 


Ay 


1. 2 
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实例 的 启动 和 停止 。 在 使 用 的 过 程 中 ， 也 无 需 创 建 用 户 和 划分 权限 。 在 系统 出 现 灾难 时 ， 如 
电源 问题 、 主 机 问题 等 ， 对 于 SQLite 而 言 ， 不 需要 做 任何 操作 。 


2. 没有 独立 的 服务 器 : 


和 其 他 关系 型 数据 库 不 同 的 是 ，SQLite 没 有 单独 的 服务 器 进程 ， 以 供 客 户 端 程序 访问 并 提供 
相关 的 服务 。SQLite 作 为 一 种 襄 入 式 数据 库 ， 其 运行 环境 与 主 程序 位 于 同一 进程 空间 ， 因 此 
它们 之 间 的 通信 完全 是 进程 内 通信 ， 而 相 比 于 进程 间 通 信 ， 其 效率 更 高 。 然 而 需要 特别 指出 


的 是 ， 该 种 结构 在 实际 运行 时 确实 存在 保护 性 较 差 的 问题 ， 比 如 此 时 ， 应 用 程序 出 现 问题 导 
致 进程 甬 溃 ， 由 于 SQLite 与 其 所 依赖 的 进程 位 于 同一 进程 空间 ， 那 么 此 时 SQLite 也 将 随 之 退 
出 。 但 是 对 于 独立 的 服务 器 进程 ， 则 不 会 有 此 问题 ， 它 们 将 在 密闭 性 更 好 的 环境 下 完成 它们 
的 工作 。 


3. 单一 磁盘 文件 : 


SQLite 的 数据 库 被 存放 在 文件 系统 的 单一 磁盘 文件 内 ， 只 要 有 权限 便 可 随意 访问 和 拷贝 ， 这 
样 带 来 的 主要 好 处 是 便于 携带 和 共享 。 其 他 的 数据 库 引 擎 ， 基 本 都 会 将 数据 库存 放 在 一 个 磁 
盘 目 录 下 ， 然 后 由 该 目录 下 的 一 组 文件 构成 该 数据 库 的 数据 文件 。 尽 管 我 们 可 以 直接 访问 这 
些 文件 ， 但 是 我 们 的 程序 却 无 法 操作 它们 ， 只 有 数据 库 实例 进程 才 可 以 做 到 。 这 样 的 好 处 是 
带 米 了 更 高 的 安全 性 和 更 好 的 性 能 ， 但 是 也 付出 了 安装 和 维护 复杂 的 代价 。 


4. 平台 无 关 性 : 


这 一 点 在 前 面 已 经 解释 过 了 。 和 SQLite 相 比 ， 很 多 数据 库 引擎 在 备份 数据 时 不 能 通过 该 方式 
直接 备份 ， 只 能 通过 数据 库 系 统 提供 的 各 种 dump 和 restore 工 具 ， 将 数据 库 中 的 数据 先导 出 到 
本 地 文件 中 ， 之 后 在 load 到 目标 数据 库 中 。 这 种 方式 存在 显而易见 的 效率 问题 ， 首 先 需要 导出 
到 另外 一 个 文件 ， 如 果 数 据 量 较 大 ， 寻 出 的 过 程 将 会 比较 耗 时 。 然 而 这 只 是 该 操作 的 一 小 部 
分 ， 因 为 数据 导入 往往 需要 更 多 的 时 间 。 数 据 在 导入 时 需要 很 多 的 验证 过 程 ， 在 存储 时 ， 也 
并 非 简 简单 单 的 顺序 存储 ， 而 是 需要 按照 一 定 的 数据 结构 、 算 法 和 策略 存放 在 不 同 的 文件 位 
置 。 因 此 和 直接 拷贝 数据 库 文 件 相 比 ， 其 性 能 是 非常 拙劣 的 。 


5. 85 2&7 : 


和 大 多 数 支持 静态 类 型 的 数据 库 不 同 的 是 ，SQLite 中 的 数据 类 型 被 视 为 数值 的 一 个 属性 。 
此 对 于 一 个 数据 表 列 而 言 ， 即 便 在 声明 该 表 时 给 出 了 该 列 的 类 型 ， 我 们 在 插入 数据 时 仍然 可 
以 插入 任意 类 型 ， 比 如 Integer 的 列 被 存 入 字符 串 'hello'。 针 对 该 特征 唯一 的 例外 是 整 型 的 主键 
列 ， 对 于 此 种 情况 ， 我 们 只 能 在 该 列 中 存储 整 型 数据 。 


6. SQL 语 句 编译 成 虚拟 机 代码 : 


很 多 数据 库 产品 会 将 SQL 语 和 句 解 析 成 复杂 的 ， 相 互 诅 套 的 数据 结构 ， 之 后 再 交 子 执行 器 遍历 
该 数据 结构 完成 指定 的 操作 。 相 比 于 此 ， SQLite 会 将 SQL 语句 先 编译 成 字 节 码 ， 之 后 再 交 由 
其 自 带 的 虚拟 机 去 执行 。 该 方式 提供 了 更 好 的 性 能 和 更 出 色 的 调试 能 力 。 


SQLite 学 习 手 册 (C/C++ 接 口 简介 ) 


一 、 概 述 : 


在 SQLite 提 供 的 C/C++ 接 口中 ， 其 中 5 个 APIS 属 于 核心 接口 。 在 这 篇 博客 中 我 们 将 主要 介绍 它 
们 的 用 法 ， 以 及 它们 所 涉及 到 的 核心 SQLite 对 象 ， 如 database_connection 和 
prepared_statement。 相 比 于 其 它 数据 库 引 擎 提供 的 APls， 如 OCI、MySQL APIF > SQLite 
提供 的 接口 还 是 非常 易于 理解 和 掌握 的 。 


、 核 心 对 象 和 接口 : 
1. 核心 对 象 : 


在 SQLite 中 最 主要 的 两 个 对 象 是 ，database_connection 和 prepared statement ° 
database_connection 对 象 是 由 sqlite3_open() 接 口 函 数 创建 并 返回 的 ， 在 应 用 程序 使 用 任何 其 
他 SQLite 接 口 函 数 之 前 ， 必 须 先 调 用 该 函数 以 便 获 得 database_connnection 对 和 象 ， 在 随后 的 
其 他 APls 调 用 中 ， 都 需要 该 对 象 作 为 输入 参数 以 完成 相应 的 工作 。 至 于 prepare_statement， 
我 们 可 以 简单 的 将 它 视 为 编译 后 的 SQL 语 句 ， 因 此 ， 所 有 和 和 SQL 语句 执 行 相关 的 函数 也 都 需 
要 该 对 象 作 为 输入 参数 以 完成 指定 的 SQL 操作 。 


2. 核心 接口 : 
1). sqlite3_open 


上 面 已 经 提 到 过 这 个 函数 了 ， 它 是 操作 SQLite 数 据 库 的 入 口 函 数 。 该 函数 返回 的 
Eu cos 象 是 很 多 其 他 SQLite APIs?) 4146 4 Jk ^ ZB? RANA A h T 
以 打开 已 经 存在 的 数据 库 文 件 ， 也 可 以 创建 新 的 数据 库 文件 。 对 于 该 函数 返回 的 
database_connection 对 象 ， 我 们 可 以 在 多 个 线程 之 间 共 享 该 对 象 的 指针 ， 以 便 完 成 和 数据 库 
相关 的 任意 操作 。 然 而 在 多 线程 情况 下 ， 我 们 更 为 推荐 的 使 用 方式 是 ， 为 每 个 线程 创建 独立 
的 database_connection 对 象 。 对 于 该 函数 还 有 一 点 也 需要 额外 说 明 ， 我 们 没有 必要 为 了 访问 
多 个 数据 库 而 创建 多 个 数据 库 连 接 对 象 ， 因 为 通过 SQLite 自 带 的 ATTACH 命 令 可 以 在 一 个 连接 
中 方便 的 访问 多 个 数据 库 。 


2). sqlite3_ prepare 


函数 将 SQL 文本 转换 为 prepared_statement 对 象 ， 并 在 函数 执行 后 返回 该 对 象 的 指针 。 事 
实 上 ， 该 函数 并 不 会 评估 参数 指定 SQL 语句 ， 它 仅仅 是 将 SQL 文本 初始 化 为 待 执行 的 状态 。 
最 后 需要 指出 的 ， 对 于 新 的 应 用 程序 我 们 可 以 使 用 sqlite3_prepare_v2 接 口 函 数 来 蔡 代 该 函数 
以 完成 相同 的 工作 。 


3). sqlite3_step 


TA HAA T 3f 4e sglite3 prepare $ 4 :& | 4) prepared statement 9 > dE WAT HK HAZA ， 
prepared _statement 对 象 的 内 部 指针 将 指向 其 返回 的 结果 集 的 第 一 行 。 如 果 打 算 进 一 步 迭 代 
其 后 的 数据 行 ， 就 需要 不 断 的 调用 该 函数 ， 直 到 所 有 的 数据 行 都 遍历 完毕 。 然 而 对 于 
INSERT 、UPDATE 和 DELETE 等 DML 语 勿 ， 该 函数 执行 一 次 即 可 完成 。 


4). sqlite3_column 


该 函数 用 于 获取 当前 行 指 定 列 的 数据 ， 然 而 严格 意义 上 讲 ， 此 函数 在 SQLite 的 接口 函数 中 并 
不 存在 ， 而 是 由 一 组 相关 的 接口 函数 来 完成 该 功能 ， 其 中 每 个 函数 都 返回 不 同类 型 的 数据 ， 
de: 


e sqlite3 column blob 
e sqlite3 column bytes 
e sqlite3 column bytes16 
e sqlite3 column double 
e sqlite3 column int 

e sglite3 column int64 
e sqlite3 column text 

e sqlite3 column text16 
e sqlite3 column type 
e sqlite3 column value 
e sqlite3 column count 


其 中 sqlite3_column_count 函 数 用 于 获取 当前 结果 集中 的 字段 数据 。 下 面 是 使 用 sqlite3_step 
和 sqlite3_column 函 数 和 迭代 结果 集中 每 行 数据 的 伪 代 码 ， 注 意 这 里 作为 示例 代码 简化 了 对 字段 
类 型 的 判断 : 


int fieldCount = sqlite3 column count(...); 
while (sqlite3_step(...) <> EOF) { 
for (int i = 0; i < fieldCount; ++i) { 
int v = sglite3 column int(...,i); 
j 


OaBRWNE 


j 


5). sqlite3 finalize 
GK EIC] T 44 9E prepared statement 对 象 ， 否 则 将 会 造成 内 存 泄露 。 


6). sqlite3_close 


该 函数 用 于 关闭 之 前 打开 的 database_connection 对 象 ， 其 中 所 有 和 该 对 象 相关 的 
prepared statements sl $ 4p o 7f E Z AY ALAR A HX © 


三 、 参 数 绑 定 : 


和 大 多 数 关系 型 数据 库 一 样 ，SQLite 的 SQL 文本 也 支持 变量 绑 定 ， 以 便 减 少 SQL 语 名 被 动态 
解析 的 次 数 ， 从 而 提高 数据 查询 和 数据 操作 的 效率 。 要 完成 该 操作 ， 我 们 需要 使 用 SQLite 提 
供 的 另外 两 个 接口 APls，sqlite3_reset 和 sqlite3_bind。 见 如 下 示例 : 


1 void test parameter binding() { 

2 //AN. 不 带 参 数 绑 定 的 情况 下 插入 多 条 数据 。 

3 char strSQL[128]; 

4 for (int i = 0; i < MAX ROWS; ++i) { 

5 sprintf(strSQL," insert into testtable values(%d)",i); 
6 sqlite3 prepare v2(..., strSQL); 

T sqlite3_step(prepared_stmt); 

8 sqlite3_finalize(prepared_stmt); 

9 } 

10 //2\. 参数 绑 定 的 情况 下 插入 多 条 数据 。 

11 string strSQLWithParameter = "insert into testtable values(?)"; 
12 sglite3 prepare v2(..., strSQL); 

13 for (int i = 0; i « MAX ROWS; ++i) { 

14 sqlite3 bind(...,i); 

15 sqlite3 step(prepared stmt); 

16 sqlite3 reset(prepared stmt); 

17 

18 sqglite3 finalize(prepared stmt); 

19 } 


这 里 首先 需要 说 明 的 是 ，SQL 语 名 "insert into testtable values(?)" 中 的 问号 (?) 表 示 参 数 变 量 的 
占 位 符 ， 该 规则 在 很 多 关系 型 数据 库 中 都 是 一 致 的 ， 因 此 这 对 于 数据 库 移 植 操作 还 是 比较 方 
便 的 。 


通过 上 面 的 示例 代码 可 以 显而易见 的 看 出 ， 参 数 绑 定 写法 的 执行 效率 要 高 于 每 次 生成 不 同 的 
SQL 语 名 的 写法 ， 即 2) 在 效率 上 要 明显 优 于 1)， 下 面 是 针对 这 两 种 写法 的 具体 比较 : 


1). 单单 从 程序 表面 来 看 ， 前 者 在 for 循 环 中 执行 了 更 多 的 任务 ， 比 如 字符 串 的 卉 充 、SQL 语 种 
的 prepare， 以 及 prepared_statement 对 象 的 释放 。 


2). 在 SQLite 的 官方 文档 中 明确 的 指出 ，sqlite3_prepare_v2 的 执行 效率 往往 要 低 于 
sqlite3_step 的 效率 。 


3). 当 插 入 的 数据 量 较 大 时 ， 后 者 带 来 的 效率 提升 还 是 相当 可 观 的 。 


SQLite 学 习 手 册 ( 数 据 表 和 视图 ) 


一 、 创 建 数据 表 : 


该 命令 的 语法 规则 和 使 用 方式 与 大 多 数 关系 型 数据 库 基 本 相同 ， 因 此 我 们 还 是 以 示例 的 方式 
来 演示 SQLite 中 创建 表 的 各 种 规则 。 但 是 对 于 一 些 SQLite 特 有 的 规则 ， 我 们 会 给 予 额外 的 说 
Woo: 以 下 所 有 示例 均 是 在 sqlite 自 带 命令 行 工具 中 完成 的 。 


1). 最 简单 的 数据 表 : 


sqlite> CREATE TABLE testtable (first col integer); 


这 里 需要 说 明 的 是 ， 对 于 自 定 义 数 据 表 表 名 ， 如 testtable， 不 能 以 sqlite 开头 ， 因 为 以 该 前 级 
定义 的 表 名 都 用 于 sqlite 内 部 。 


2). 创建 带 有 缺 省 值 的 数据 表 : 


sqlite> CREATE TABLE testtable (first col integer DEFAULT ©, second col varchar DEFAULT ' 





3) 在 指定 数据 库 创建 表 : 


sqlite> ATTACH DATABASE 'd:/mydb.db' AS mydb; 
sqlite> CREATE TABLE mydb.testtable (first col integer); 


这 里 先 通过 ATTACH DATABASE 命 令 将 一 个 已 经 存在 的 数据 库 文件 attach 到 当前 的 连接 中 ， 
之 后 再 通过 指定 数据 库 名 的 方式 在 目标 数据 库 中 创建 数据 表 ， 如 mydb.testtable。 关 于 该 规则 
还 需要 给 出 一 些 额外 的 说 明 ， 如 果 我 们 在 创建 数据 表 时 没有 指定 数据 库 名 ， 那 么 将 会 在 当前 
连接 的 main 数 据 库 中 创建 该 表 ， 在 一 个 连接 中 只 能 有 一 个 main 数 据 库 。 如 果 需 要 创建 临时 
表 ， 就 无 需 指定 数据 库 名 ， 见 如 下 示例 : 


-- 创 建 两 个 表 ， 一 个 临时 表 和 普通 表 。 


sqlite> CREATE TEMP TABLE temptable(first col integer); 
sqlite> CREATE TABLE testtable (first col integer); 


-- 将 当前 连接 中 的 缓存 数据 导出 到 本 地 文件 ， 同 时 退出 当前 连接 。 


sqlite> backup d:/mydb.db 
sqlite> exit 


-- 重 新 建立 sqlite 的 连接 ， 并 将 刚刚 导出 的 数据 库 作为 主 库 重新 导入 。 


sqlite> restore d:/mydb.db 


-- 查 看 该 数据 库 中 的 表 信 息 ， 通 过 结果 可 以 看 出 临时 表 并 没有 被 持久 化 到 数据 库 文件 中 。 


sqlite> .tables 
testtable 


4). "IF NOT EXISTS" 从 句 : 


如 果 当 前 创建 的 数据 表 名 已 经 存在 ， 即 与 已 经 存在 的 表 名 、 视 图 名 和 索引 名 冲突 ， 那 么 本 次 
创建 操作 将 失败 并 报错 。 然 而 如 果 在 创建 表 时 加 上 "IF NOT EXISTS" 4) > MAAR SI AEE 
将 不 会 有 任何 影响 ， 即 不 会 有 错误 抛 出 ， 除 非 当 前 的 表 名 和 某 一 索引 名 冲突 。 


sqlite> CREATE TABLE testtable (first col integer); 
Error: table testtable already exists 
sqlite> CREATE TABLE IF NOT EXISTS testtable (first col integer); 


5). CREATE TABLE ... AS SELECT : 


通过 该 方式 创建 的 数据 表 将 与 SELECT 查询 返回 的 结果 集 具 有 相同 的 Schema 信息 ， 但 是 不 包 
含 缺 省 值 和 主键 等 约束 信息 。 然 而 新 创建 的 表 将 会 包含 结果 集运 回 的 所 有 数据 。 


sqlite> CREATE TABLE testtable2 AS SELECT * FROM testtable; 
sqlite> .schema testtable2 
CREATE TABLE testtable2(first col INT); 


.Schema 命令 是 sqlite3 命 令 行 工 具 的 内 置 命令 ， 用 于 显示 当前 数据 表 的 CREATE TABLE i$ 
4o 


6) 主键 约束 : 
-- 直 接 在 字段 的 定义 上 指定 主键 。 


sqlite> CREATE TABLE testtable (first col integer PRIMARY KEY ASC 


-- 在 所 有 字段 已 经 定义 完毕 后 ， 再 定义 表 的 数 约束 ， 这 里 定义 的 是 基于 first colfesecond col 
的 联合 主键 。 


sqlite> CREATE TABLE testtable2 ( 


> first_col integer, 
ds second col integer, 

> PRIMARY KEY (first_col,second col) 
ez): 


和 其 他 关系 型 数据 库 一 样 ， 主 键 必 须 是 唯一 的 。 


7). 唯一 性 约束: 
-- 直 接 在 字段 的 定义 上 指定 唯一 性 约束 。 


sqlite> CREATE TABLE testtable (first col integer UNIQUE); 


-- 在 所 有 字段 已 经 定义 完毕 后 ， 在 定义 表 的 唯一 性 约束 ， 这 里 定义 的 是 基于 两 个 列 的 唯一 性 约 
束 o 


sqlite> CREATE TABLE testtable2 ( 


bem first col integer, 
uper second col integer, 

bene UNIQUE (first col,second col) 
emo 


在 SQLite 中 ，NULL 值 被 视 为 和 其 他 任何 值 都 是 不 同 的 ， 这 样 包括 和 其 他 的 NULL 值 ， 如 下 
f]: 


sqlite> DELETE FROM testtable; 
sqlite> SELECT count(*) FROM testtable; 
count(*) 


sqlite> INSERT INTO testtable VALUES(NULL); 
sqlite> INSERT INTO testtable VALUES(NULL); 
sqlite> SELECT count(*) FROM testtable; 
count (*) 


由 此 可 见 ， 两 次 播 入 的 NULL 值 均 播 入 成 功 。 


8). 为 空 NOT NULL) 约 束 : 


sqlite> CREATE TABLE testtable(first col integer NOT NULL); 
sqlite> INSERT INTO testtable VALUES(NULL); 
Error: testtable.first_col may not be NULL 


从 输出 结果 可 以 看 出 ，first_col 已 经 被 定义 了 非 空 约束 ， 因 此 不 能 在 插入 NULL 值 了 。 


9). 检查 性 约束 : 


sqlite> CREATE TABLE testtable (first col integer CHECK (first col < 5)); 

sqlite> INSERT INTO testtable VALUES(4); 

sqlite> INSERT INTO testtable VALUES(20); _-- 20 违 反 了 字段 first_col 的 检查 性 约束 (first_col < £ 
Error: constraint failed 


一 > 
-- 和 之 前 的 其 它 约束 一 样 ， 检 查 性 约束 也 是 可 以 基于 表 中 的 多 个 列 来 定义 的 。 





sqlite> CREATE TABLE testtable2 ( 


> first_col integer, 
renes second col integer, 
> CHECK (first col > © AND second col < 0) 


ez); 


二 、 表 的 修改 : 


SQLite 对 ALTER TABLE 命 令 支持 的 非常 有 限 ， 仅 仅 是 修改 表 名 和 添加 新 字段 。 其 它 的 功能 ， 
如 重 命名 字段 、 删 除 字 段 和 添加 删除 约束 等 均 为 提供 支持 。 


1). FRA: 


需要 先 说 明 的 是 ，SQLite 中 表 名 的 修改 只 能 在 同一 个 数据 库 中 ， ST 能 将 其 移动 到 Attached 数 
据 库 中 。 再 有 就 是 一 旦 表 名 被 修改 后 ， 该 表 已 存在 的 索引 将 不 会 受到 有 影响， 然而 依赖 该 表 的 
视图 和 触发 器 将 不 得 不 重新 修改 其 定义 。 

sqlite> CREATE TABLE testtable (first_col integer); 

sqlite> ALTER TABLE testtable RENAME TO testtable2; 


sqlite> .tables 
testtable2 


通过 .tables 命 令 的 输出 可 以 看 出 ， 表 testtable 已 经 被 修改 为 testtable2 ° 
2). 新 增 字段 : 


sqlite> CREATE TABLE testtable (first col integer); 

sqlite> ALTER TABLE testtable ADD COLUMN second col integer; 
sqlite> ,Schema testtable 

CREATE TABLE "testtable" (first_col integer, second_col integer); 


通过 .schema 命 令 的 输出 可 以 看 出 ， 表 testtable 的 定义 中 已 经 包含 了 新 增 字 段 。 


关于 ALTER TABLE 有 最 后 需要 说 明 的 是 ， 在 SQLite 中 该 命令 的 执行 时 间 是 不 会 受到 当前 表 行 数 
的 影响 ， 也 就 是 说 ， 修 改 有 一 千 万 行 数据 的 表 和 修改 只 有 一 条 数据 的 表 所 需 的 时 间 几 乎 是 相 
等 的 。 


三 、 表 的 删除 : 


在 SQLite 中 如 果 某 个 表 被 删除 了 ， 那 么 与 之 相关 的 索引 和 触发 器 也 会 被 随 之 删除 。 在 很 多 其 
他 的 关系 型 数据 库 中 是 不 可 以 这 样 的 ， 如 果 必 须要 删除 相关 对 象 ， 只 能 在 删除 表 语 名 中 加 入 
WITH CASCADE 从 和 句 。 见 如 下 示例 : 


sqlite> CREATE TABLE testtable (first col integer); 
sqlite> DROP TABLE testtable; 

sqlite> DROP TABLE testtable; 

Error: no such table: testtable 

sqlite> DROP TABLE IF EXISTS testtable; 


从 上 面 的 示例 中 可 以 看 出 ， 如 果 删 除 的 表 不 存在 ，SQLite 将 会 报错 并 输出 错误 信息 。 如 果 项 
望 在 执行 时 不 抛 出 异常 ， 我 们 可 以 添加 IF EXISTS 从 和 句 ， 该 从 和 句 的 语义 和 CREATE TABLE 中 
的 完全 相同 。 


四 、 创 建 视 图 : 


我 们 这 里 只 是 给 出 简单 的 SQL 命令 示例 ， 有 具体 的 含义 和 技术 细节 可 以 参照 上 面 的 创建 数据 表 
部 分 ， 如 临时 视图 、"IF NOT EXISTS" 4) # © 


1). 最 简单 的 视图 : 


sqlite> CREATE VIEW testview AS SELECT * FROM testtable WHERE first col > 100; 


2). 创建 临时 视图 : 


sqlite> CREATE TEMP VIEW tempview AS SELECT * FROM testtable WHERE first col > 100; 


3). "IF NOT EXISTS" 4] : 


sqlite> CREATE VIEW testview AS SELECT * FROM testtable WHERE first col > 100; 
Error: table testview already exists 
sqlite> CREATE VIEW IF NOT EXISTS testview AS SELECT * FROM testtable WHERE first col > 1 


BE LL LttLL. o 


五 、 删 除 视图 : 





该 操作 的 语法 和 删除 表 基 本 相同 ， 因 此 这 里 只 是 给 出 示例 : 


sqlite> DROP VIEW testview; 

sqlite> DROP VIEW testview; 

Error: no such view: testview 
sqlite> DROP VIEW IF EXISTS testview; 


SQLite d H(A E £X) 


-` RE dE: 


SQLite 中 支持 的 聚合 函数 在 很 多 其 他 的 关系 型 数据 库 中 也 同样 支持 ， 因 此 我 们 这 里 将 只 是 给 
出 每 个 聚集 函数 的 简要 说 明 ， 而 不 在 给 出 更 多 的 示例 了 。 这 里 还 需要 进一步 说 明 的 是 ， 对 于 
所 有 聚合 函数 而 言 ，distinct 关 键 字 可 以 作为 函数 参数 字段 的 前 置 属性 ， 以 便 在 进行 计算 时 忽 
略 到 所 有 重复 的 字段 值 ， 如 count(distinct x) ° 


avg(x) 


函数 


count(x|*) 


group_concat(x[,y]) 


max(x) 


min(x) 


sum(x) 


total(x) 


二 、 核 心 


函数 : 


说 明 


该 函数 返回 在 同一 组 内 参数 字段 的 平均 值 。 对 于 不 能 转换 为 数字 
值 的 String 和 BLOB 类 型 的 字段 值 ， 如 'HELLO'，SQLite 会 将 其 视 
为 0。avg 函 数 的 结果 总 是 浮 点 型 ， 唯 一 的 例外 是 所 有 的 字段 值 均 
为 NULL， 那 样 该 函数 的 结果 也 为 NULL © 


count(xX) 函 数 返 回 在 同一 组 内 ，X 字 段 中 值 不 等 于 NULL 的 行 数 。 
count(*) $ 4k 3& t] E Is] — 28 Pj 8$ AGE AT A o 


该 函数 返回 一 个 字符 串 ， 该 字符 串 将 会 连接 所 有 非 NULL 的 x 值 。 
该 函数 的 y 参 数 将 作为 每 个 x 值 之 间 的 分 隔 符 ， 如 果 在 调用 时 忽略 
该 参数 ， 在 连接 时 将 使 用 缺 省 分 隔 符 ","。 再 有 就 是 各 个 字符 串 之 
间 的 连接 顺序 是 不 确定 的 。 


该 函数 返回 同一 组 内 的 x 字段 的 最 大 值 ， 如 果 该 字段 的 所 有 值 均 为 
NULL > 该 函数 也 返回 NULL 。 


该 函数 返回 同一 组 内 的 x 字段 的 最 小 值 ， 如 果 该 字段 的 所 有 值 均 为 
NULL > 该 函数 也 返回 NULL 。 


该 函数 返回 同一 组 内 的 x 字段 值 的 总 和 ， 如 果 字 段 值 均 为 NULL ， 
该 函数 也 返回 NULL。 如 果 所 有 的 x 字段 值 均 为 整 型 或 者 NULL， 该 
函数 返回 整 型 值 ， 否 则 就 返回 浮 点 型 数值 。 最 后 需要 指出 的 是 ， 
如 果 所 有 的 数据 值 均 为 整 型 ， 一 旦 结果 超过 上 限时 将 会 抛 

出 "integer overflow" 的 异常 。 


该 函数 不 属于 标准 SQL， 其 功能 和 sum 基 本 相同 ， 只 是 计算 结果 上 比 
sum 更 为 合理 。 比 如 当 所 有 字段 值 均 为 NULL 时 ， 和 sum 不 同 的 

是 ， 该 函数 返回 0.0。 再 有 就 是 该 函数 始终 返回 浮 点 型 数值 。 该 苑 
数 始 终 都 不 会 抛 出 异常 。 


以 下 函数 均 为 SQLite 缺 省 提供 的 内 置 函 数 ， 其 声明 和 描述 见 如 下 列表 : 


abs(X) 


说 明 


该 函数 返回 数值 参数 X 的 绝对 值 ， 如 果 X 为 NULL， 则 返回 
NULL， 如 果 X 为 不 能 转换 成 数值 的 字符 囊 ， 则 返回 0， 如 果 X 值 
超出 Integer 的 上 限 ， 则 抛 出 "Integer Overflow" 的 异常 。 


changes() 


coalesce(X,Y,...) 


ifnull(X, Y) 


length(X) 


lower(X) 


Itrim(X[, Y]) 


max(X, Y,...) 


min(X,Y,...) 


nullif(X, Y) 


random() 


replace(X,Y,Z) 


round(X[,Y]) 


rtrim(X[,Y1) 


substr(X, Y[,Z]) 


total_changes() 


trim(x[,y]) 


upper(X) 


该 函数 返回 最 近 执 行 的 INSERT、UPDATE 和 DELETE 语 多 所 影 
响 的 数据 行 数 。 我 们 也 可 以 通过 执行 C/C++ 函数 
sqlite3_changes() 得 到 相同 的 结果 。 


返回 函数 参数 中 第 一 个 非 NULL 的 参数 ， 如 果 参 数 都 是 NULL， 则 
返回 NULL 。 该 函数 至 少 2 个 参数 。 


该 函数 等 同 于 两 个 参数 的 coalesce() 函 数 ， 即 返回 第 一 个 不 为 
NULLI Bak AB > de R08 25 79 NULL. > MA EINULL © 


如 果 参 数 X 为 字符 串 ， 则 返回 字符 的 数量 ， 如 果 为 数值 ， 则 返回 
该 参数 的 字符 串 表示 形式 的 长 度 ， 如 果 为 NULL， 则 返回 NULL © 


返回 函数 参数 X 的 小 写 形 式 ， 缺 省 情况 下 ， 该 函数 只 能 应 用 于 
ASCII #4 o 


如 果 没 有 可 选 参数 Y， 该 函数 将 移 除 参数 X 左 侧 的 所 有 空格 符 。 
如 果 有 参数 Y， 则 移 除 X 左 侧 的 任意 在 Y 中 出 现 的 字符 。 最 后 返回 
移 除 后 的 字符 串 。 


返回 函数 参数 中 的 最 大 值 ， 如果 有 任何 一 个 参数 为 NULL， 则 返 
回 NULL。 


返回 函数 参数 中 的 最 小 值 ， 如果 有 任何 一 个 参数 为 NULL， 则 返 
回 NULL。 


如 果 函 数 参 数 相 同 ， 返 回 NULL， 和 否则 返回 第 一 个 参数 。 
返回 整 型 的 伪 随 机 数 。 


将 字符 串 类 型 的 函数 参数 X 中 所 有 子 字符 串 Y 替 换 为 字符 串 Z， 最 
芭 


如 果 没 有 可 选 参数 Y， 该 函数 将 移 除 参数 X 右 侧 的 所 有 空格 符 。 
如 果 有 参数 Y， 则 移 除 X 右 侧 的 任意 在 Y 中 出 现 的 字符 。 最 后 返回 
移 除 后 的 字符 串 。 


返回 函数 参数 X 的 子 字 符 串 ， 从 第 Y 位 开始 (X 中 的 第 一 个 字符 位 
置 为 1) 截 取 Z 长 度 的 字符 ， 如 果 忽 略 Z 参 数 ， 则 取 第 Y 个 字符 后 面 
的 所 有 字符 。 如 果 Z 的 值 为 负数 ， 则 从 第 Y 位 开始 ， 向 左 截取 
abs(Z) 个 字符 。 如 果 Y 值 为 负数 ， 则 从 X 字 符 串 的 尾部 开始 计数 到 
第 abs(Y) 的 位 置 开 始 。 


该 函数 返回 自从 该 连接 被 打开 时 起 ，|INSERT、UPDATE 和 
DELETE 语 名 总 共 影响 的 行 数 。 我 们 也 可 以 通过 C/C++ 接口 济 数 
sqlite3_total_changes() 得 到 相同 的 结果 。 


如 果 没 有 可 选 参数 Y， 该 函数 将 移 除 参数 X 两 侧 的 所 有 空格 符 。 
如 果 有 参数 Y， 则 移 除 X 两 侧 的 任意 在 Y 中 出 现 的 字符 。 最 后 返回 
移 除 后 的 字符 串 。 


返回 函数 参数 X 的 大 写 形式 ， 缺 省 情况 下 ， 该 芳 数 只 能 应 用 于 
ASCII 字 符 。 


返回 函数 参数 数据 类 型 的 字符 串 表 示 形 式 ， 如 "Integer、text、 


real、null" 等 。 
= > AFH A) BR: 


SQLite 主 要 支持 以 下 四 种 与 日 期 和 时 间 相 关 的 函数 ， 如 : 


1). date(timestring, modifier, modifier, ...) 

2). time(timestring, modifier, modifier, ...) 

3). datetime(timestring, modifier, modifier, ...) 

4). strftime(format, timestring, modifier, modifier, ...) 


以 上 所 有 四 个 函数 都 接受 一 个 时 间 字 符 串 作为 参数 ， 其 后 再 跟 有 0 个 或 多 个 修改 符 。 其 中 
strftime() 函 数 还 接受 一 个 格式 字符 串 作 为 其 第 一 个 参数 。strftime() 和 C 运 行 时 库 中 的 同名 函数 
完全 相同 。 至 于 其 他 三 个 函数 ，date 函 数 的 缺 省 格式 为 : "YYYY-MM-DD" > time 83k 89 ik 4 4% 
式 为 : "HH:MM:SS"，datetime 函 数 的 缺 省 格式 为 : "YYYY-MM-DD HH:MM:SS" ° 


1. strftime 函 数 的 格式 信息 : 


格式 说 明 
Jod day of month: 00 
%f fractional seconds: SS.SSS 
%H hour: 00-24 
%j day of year: 001-366 
%J Julian day number 
%m month: 01-12 
%M minute: 00-59 
%S seconds since 1970-01-01 
%S seconds: 00-59 
Yw day of week 0-6 with Sunday==0 
%W week of year: 00-53 
o Y year: 0000-9999 
%% % 


需要 额外 指出 的 是 ， 其 余 三 个 时 间 部 数 均 可 用 strftime 来 表示 ， 如 : 


date(...) strftime('%Y-%m-%d', ...) 
time(...) strftime('%H:%M:%S', ...) 
datetime(...) strftime('%Y-%m-%d %H:%M:%S', ...) 


2. 时 间 字 符 串 的 格式 : 
见 如 下 列表 : 

1). YYYY-MM-DD 

2). YYYY-MM-DD HH:MM 

3). YYYY-MM-DD HH:MM:SS 
4). YYYY-MM-DD HH:MM:SS.SSS 
5). HH:MM 

6). HH:MM:SS 

7). HH:MM:SS.SSS 

8). now 

5) 到 7) 中 只 是 包含 了 时 间 部 分 ，SQLite 将 假设 日 期 为 2000-01-01。8) 表 示 当 前 时 间 。 
3. 修改 符 : 

见 如 下 列表 : 

1). NNN days 

2). NNN hours 

3). NNN minutes 

4). NNN.NNNN seconds 

5). NNN months 

6). NNN years 

7). start of month 

8). start of year 

9). start of day 

10).weekday N 


1) 到 6) 将 只 是 简单 的 加 减 指定 数量 的 日 期 或 时 间 值 ， 如 果 NNN 的 值 为 负数 ， 则 减 ， 否 则 加 。7) 
到 9) 则 将 时 间 串 中 的 指定 日 期 部 分 设置 到 当前 月 、 年 或 日 的 开始 。10) 则 将 日 期 前 进 到 下 一 个 
星期 N， 其 中 星期 日 为 0。 注 : 修改 符 的 顺序 极为 重要 ，SQLite 将 会 按照 从 左 到 右 的 顺序 依次 
执行 修改 符 。 


4. 示例 : 


-- 返 回 当 前 日 期 。 


sqlite> SELECT date('now'); 
2012-01-15 


-- 返 回 当 前 月 的 最 后 一 天 。 


sqlite> SELECT date('now','start of month','1 month','-1 day'); 
2012-01-31 


--i& E 1970-01-01 00:00:00 到 当前 时 间 所 流 经 的 秒 数 。 


sqlite> SELECT strftime('%s', 'now'); 
1326641166 


-- 返 回 当 前 年 中 10 月 份 的 第 一 个 星期 二 是 日 期 。 


sqlite> SELECT date('now','start of year','+9 months', 'weekday 2'); 
2012-10-02 


SQLite 学 习 手 册 ( 索 引 和 数据 分 析 / 清 理 ) 


一 、 创 建 索引 : 


在 SQLite 中 ， 创 建 索引 的 SQL 语法 和 其 他 大 多 数 关系 型 数据 库 基 本 相同 ， 因 为 这 里 也 仅仅 是 
给 出 示例 用 法 : 


sqlite> CREATE TABLE testtable (first col integer,second col integer); 


-- 创 建 最 简单 的 索引 ， 该 索引 基于 某 个 表 的 一 个 字段 。 

sqlite> CREATE INDEX testtable idx ON testtable(first col); 
-- 创 建 联合 索引 ， 该 索引 基于 某 个 表 的 多 个 字段 ， 同 时 可 以 指定 每 个 字段 的 排序 规则 (升序 / 降 
m): 

sqlite> CREATE INDEX testtable idx2 ON testtable(first col ASC,second col DESC); 


-创建 唯一 性 索引 ， 该 索引 规则 和 数据 表 的 唯一 性 约束 的 规则 相同 ， 即 NULL 和 任何 值 都 不 
同 ， 包 括 NULL 本 身 。 


sqlite> CREATE UNIQUE INDEX testtable idx3 ON testtable(second col DESC); 
sqlite> .indices testtable 

testtable idx 

testtable idx2 

testtable idx3 


从 .indices 命 令 的 输出 可 以 看 出 ， 三 个 索引 均 已 成 功 创建 。 

二 、 删 除 索引 : 

索引 的 删除 和 视图 的 删除 非常 相似 ， 含 义 也 是 如 此 ， 因 此 这 里 也 只 是 给 出 示例 : 
sqlite> DROP INDEX testtable idx; 


-- 如 果 删 除 不 存在 的 索引 将 会 导致 操作 失败 ， 如 果 在 不 确定 的 情况 下 又 不 希望 错误 被 抛 出 ， 可 
以 使 用 "IF EXISTS" 从 名 ° 


sqlite> DROP INDEX testtable idx; 
Error: no such index: testtable idx 
sqlite> DROP INDEX IF EXISTS testtable idx; 


三 、 重 建 索引 : 


重建 索引 用 于 删除 已 经 存在 的 索引 ， 同 时 基于 其 原 有 的 规则 重建 该 索引 。 这 里 需要 说 明 的 
是 ， 如 果 在 REINDEX 语 句 后 面 没 有 给 出 数据 库 名 ， 那 么 当前 连接 下 所 有 Attached 数 据 库 中 所 
有 索引 都 会 被 重建 。 如 果 指 定 了 数据 库 名 和 表 名 ， 那 么 该 表 中 的 所 有 索引 都 会 被 重建 ， 如 果 
只 是 指定 索引 名 ， 那 么 当前 数据 库 的 指定 索引 被 重建 。 


-- 当 前 连接 attached 所 有 数据 库 中 的 索引 都 被 重建 。 


sqlite> REINDEX; 


-- 重 建 当 前 主 数据 库 中 testtable 表 的 所 有 索引 。 


sqlite> REINDEX testtable; 


-- 重 建 当 前 主 数据 库 中 名 称 为 testtable idx25 #4] » 

sqlite> REINDEX testtable idx2; 
四 、 数 据 分 析 : 
和 PostgreSQL 非 常 相 似 ，SQLite 中 的 ANALYZE 命 令 也 同样 用 于 分 析 数 据 表 和 索引 中 的 数 
据 ， 并 将 统计 结果 存放 于 SQLite 的 内 部 系统 表 中 ， 以 便于 查询 优化 器 可 以 根据 分 析 后 的 统计 
数据 选择 最 优 的 查询 执行 路 径 ， 从 而 提高 整个 查询 的 效率 。 见 如 下 示例 : 


-- 如 果 在 ANALYZE 命 令 之 后 没有 指定 任何 参数 ， 则 分 析 当 前 连接 中 所 有 Attached 数 据 库 中 的 
表 和 索引 。 


sqlite> ANALYZE; 


-- 如 果 指 定数 据 库 作 为 ANALYZE 的 参数 ， 那 么 该 数据 库 下 的 所 有 表 和 索引 都 将 被 分 析 并 生成 
统计 数据 。 


sqlite> ANALYZE main; 


-- 如 果 指 定 了 数据 库 中 的 某 个 表 或 索引 为 ANALYZE 的 参数 ， 那 么 该 表 和 其 所 有 关联 的 索引 都 
将 被 分 析 。 


sqlite> ANALYZE main.testtable; 
sqlite> ANALYZE main.testtable idx2; 


五 、 数 据 清 理 : 


和 PostgreSQL 中 的 VACUUM 命令 相 比 ， 他 们 的 功能 以 及 实现 方式 非常 相似 ， 不 同 的 是 
PostgreSQL 提 供 了 更 细 的 粒度 ， 而 SQLite 只 能 将 该 命令 作用 于 数据 库 ， 无 法 再 精确 到 数据 库 
中 指定 的 数据 表 或 者 索引 ， 然 而 这 一 点 恰恰 是 PostgreSQL 可 以 做 到 的 。 


当 某 个 数据 库 中 的 一 个 或 多 个 数据 表 存 在 大 量 的 插入 、 更 新 和 删除 等 操作 时 ， 将 会 有 大 量 的 
磁盘 空间 被 已 删除 的 数据 所 占用 ， 在 没有 执行 VACUUM 命令 之 前 ，SQLite 并 没有 将 它们 归还 
于 操作 系统 。 由 于 该 类 数据 表 中 的 数据 存储 非常 分 散 ， 因 此 在 查询 时 ， 无 法 得 到 更 好 的 批量 
IO 读 取 效 果 ， 从 而 影响 了 查询 效率 。 


在 SQLite 中 ， 仅 支持 清理 当前 连接 中 的 主 数据 库 ， 而 不 能 清理 其 它 Attached 数 据 库 。 
VACUUM 命令 在 完成 数据 清理 时 采用 了 和 PostgreSQL 相 同 的 策略 ， 即 创建 一 个 和 当前 数据 库 
文件 相同 大 小 的 新 数据 库 文件 ， 之 后 再 将 该 数据 库 文件 中 的 数据 有 组 织 的 导入 到 新 文件 中 ， 
其 中 已 经 删除 的 数据 块 将 不 会 被 导入 ， 在 完成 导入 后 ， 收 缩 新 数据 库 文 件 的 尺寸 到 适当 的 大 
小 。 该 命令 的 执行 非常 简单 ， 如 : 


sqlite» VACUUM; 


SQLite 学 习 手 册 ( 数 据 库 和 事务 ) 


一 、Attach 数 据 库 : 


ATTACH DATABASE 语 名 添加 另外 一 个 数据 库 文件 到 当前 的 连接 中 ， 如 果 文 件 名 

为 ":memory:"， 我 们 可 以 将 其 视 为 内 存 数 据 库 ， 内 存 数据 库 无 法 持久 化 到 磁盘 文件 上 。 如 果 操 
作 Attached 数 据 库 中 的 表 ， 则 需要 在 表 名 前 加 数据 库 名 ， 如 dbname.table_name 。 最 后 需要 
说 明 的 是 ， 如 果 一 个 事务 包含 多 个 Attached 数 据 库 操作 ， 那 么 该 事务 仍然 是 原子 的 。 见 如 下 
m: 


sqlite> CREATE TABLE testtable (first col integer); 

sqlite> INSERT INTO testtable VALUES(1); 

sqlite> .backup 'D:/mydb.db'  ”_-- 将 当前 连接 中 的 主 数据 库 备份 到 指定 文件 。_ 
sqlite> .exit 


-- 重 新 登录 sqlite 命 令 行 工具 : 


sqlite> CREATE TABLE testtable (first col integer); 

sqlite> INSERT INTO testtable VALUES(2); 

sqlite> INSERT INTO testtable VALUES(1); 

sqlite> ATTACH DATABASE 'D:/mydb.db' AS mydb; 

sqlite> .header on - -查询 结果 将 字段 名 作为 标题 输出 。 

sqlite> .mode column -- 将 每 列 都 分 开 显 示 。 

sqlite> SELECT ti.first col FROM testtable t1, mydb.testtable t2 WHERE t.first col = t2.f 
first col 


EE 


二 、Detach 数 据 库 : 





印 载 将 当前 连接 中 的 指定 数据 库 ， 注 意 main 和 temp 数 据 库 无 法 被 印 载 。 见 如 下 示例 : 


-- 该 示例 承载 上 面 示例 的 结果 ， 即 mydb 数 据 库 已 经 被 Attach 到 当前 的 连接 中 。 


sqlite> DETACH DATABASE mydb; 
sqlite> SELECT ti.first col FROM testtable ti, mydb.testtable t2 WHERE t.first col = t2.f 
Error: no such table: mydb.testtable 
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三 、 事 务 : 





在 SQLite 中 ， 如 果 没 有 为 当前 的 SQL 命令 (SELECT 除外 ) 显 示 的 指定 事务 ， 那 么 SQLite 会 自动 
为 该 操作 添加 一 个 隐 式 的 事务 ， 以 保证 该 操作 的 原子 性 和 一 臻 性。 当然，SQLite 也 支持 显示 
的 事务 ， 其 语法 与 大 多 数 关系 型 数据 库 相 比 基 本 相同 。 见 如 下 示例 : 


sqlite> BEGIN TRANSACTION; 
sqlite> INSERT INTO testtable VALUES(1); 
sqlite> INSERT INTO testtable VALUES(2); 


sqlite> COMMIT TRANSACTION; -- 显 示 事 务 被 提交 ， 数 据 表 中 的 数据 也 发 生 了 变化 。 
sqlite> SELECT COUNT(*) FROM testtable; 

COUNT(*) 

2 


sqlite> BEGIN TRANSACTION; 

sqlite> INSERT INTO testtable VALUES(1); 

sqlite> ROLLBACK TRANSACTION;  -- 显 示 事 务 被 回 滚 ， 数 据 表 中 的 数据 没有 发 生变 化 。 
sqlite> SELECT COUNT(*) FROM testtable; 

COUNT(*) 


SQLite 学 习 手 册 ( 表 达 式 ) 


一 、 常 用 表达 式 : 


和 大 多 数 关 系 型 数据 库 一 样 ，SQLite 能 够 很 好 的 支持 SQL 标 准 中 提供 的 表达 式 ， 其 函数 也 与 
SQL 标 准 保持 一 致 ， 如 : 


!= <> IS IS NOT IN LIKE 


= NOT 


在 上 面 的 表达 式 中 ， 唯 一 需要 说 明 的 是 "||"， 该 表达 式 主要 用 于 两 个 字符 串 之 间 的 连接 ， 其 返 
回 值 为 连接 后 的 字符 串 ， 即 便 该 操作 符 两 边 的 操作 数 为 非 字 符 串 类 型 ， 在 执行 该 表达 式 之 前 
都 需要 被 提前 转换 为 字符 串 类 型 ， 之 后 再 进行 连接 。 

二 、 条 件 表达 式 : 

该 表达 式 的 语法 规则 如 下 : 


1). CASE x WHEN wi THEN ri WHEN w2 THEN r2 ELSE r3 END 
2). CASE WHEN x=w1 THEN ri WHEN x-w2 THEN r2 ELSE r3 END 


对 于 第 一 种 情况 ， 条 件 表 达 式 X 只 需 计 算 一 次 ， 然 后 分 别 和 WHEN 关键 字 后 的 条 件 和 逐一 进行 比 
较 ， 直 到 找到 相等 的 条 件 ， 其 比较 规则 等 价 于 等 号 (=) 表 达 式 。 如 果 找 到 匹配 的 条 件 ， 则 返回 
其 后 THEN 关 键 字 所 指向 的 值 ， 如 果 没 有 找到 任何 匹配 ， 则 返回 ELSE 关 键 字 之 后 的 值 ， 如 果 
不 存在 ELSE 分 支 ， 则 返回 NULL。 对 于 第 二 种 情况 ， 和 第 一 种 情况 相 比 ， 唯 一 的 差别 就 是 表 
达 式 X 可 能 被 多 次 执行 ， 比 如 第 一 个 WHEN 条 件 不 匹配 ， 则 继续 计算 后 面 的 WHEN 条 件 ， 其 它 
规则 均 与 第 一 种 完全 相同 。 最 后 需要 说 明 的 是 ， 以 上 两 种 形式 的 CASE 表 达 式 均 遵 守 短 路 原 

则 ， 即 第 一 个 表达 式 的 条 件 一 旦 匹配 ， 其 后 所 有 的 WHEN 表 达 式 均 不 会 再 被 执行 或 比较 。 


三 、 转 换 表 达 式 : 


该 表达 式 的 语法 规则 如 下 : 


CAST(expr AS target_type) 


该 表达 式 会 将 参数 expr 转 换 为 target_type 类 型 ， 具 体 的 转换 规则 见 如 下 列表 : 


REAL 


INTEGER 


NUMERIC 


转换 规则 描述 


如 果 转 换 INTEGER 或 REAL 类 型 的 值 到 TEXT 类 型 直接 转换 即 可 ， 就 像 
C/C++ 接口 函数 sqlite3_snprintf 所 完成 的 工作 。 


如 果 转 换 TEXT 类 型 的 值 到 REAL 类 型 ， 在 该 文本 的 最 前 部 ， 将 可 以 转 
换 为 实数 的 文本 转换 为 相应 的 实数 ， 其 余部 分 忽略 。 其 中 该 文本 值 的 
前 导 零 亦 将 被 全 部 忽略 。 如 果 该 文本 值 没 有 任何 字符 可 以 转换 为 实 
数 ，CAST 表 达 式 的 转换 结果 为 0.0。 


如 果 转 换 TEXT 类 型 的 值 到 INTEGER 类 型 ， 在 该 文本 的 最 前 部 ， 将 可 
以 转换 为 整数 的 文本 转换 为 相应 的 整数 ， 其 余部 分 忽略 。 其 中 该 文本 
值 的 前 导 零 亦 将 被 全 部 忽略 。 如 果 该 文本 值 没有 任何 字符 可 以 转换 为 
整数 ，CAST 表 达 式 的 转换 结果 为 0。 如 果 转 换 将 一 个 实数 值 转换 为 
INTEGER 类 型 ， 则 直接 截断 实数 小 数 部 分 。 如 果实 数 过 大 ， 则 返回 最 
大 的 负 整 数 : -0223372036854775808 ° 


如 果 转 换文 本 值 到 NUMERIC 类 型 ， 则 先 将 该 值 强制 转换 为 REAL 类 
型 ， 只 有 在 将 REAL 转 换 为 INTEGER 不 会 导致 数据 信息 丢失 以 及 完全 
可 逆 的 情况 下 ，SQLite 才 会 进一步 将 其 转换 为 INTEGER 类 型 。 


最 后 需要 说 明 的 是 ， 如 果 expr 为 NULL， 则 转换 的 结果 也 为 NULL。 
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一 、 存 储 种 类 和 数据 类 型 : 

SQLite 将 数据 值 的 存储 划分 为 以 下 几 种 存储 类 型 : 

NULL: 表示 该 值 为 NULL 值 。 

INTEGER: 无 符号 整 型 值 。 

REAL: 浮 点 值 。 

TEXT: 文本 字符 串 ， 存 储 使 用 的 编码 方式 为 UTF-8、UTF-16BE、UTF-16LE ° 
BLOB: 存储 Blob 数 据 ， 该 类 型 数据 和 输入 数据 完全 相同 。 


由 于 SQLite 采 用 的 是 动态 数据 类 型 ， 而 其 他 传统 的 关系 型 数据 库 使 用 的 是 静态 数据 类 型 ， 即 
字段 可 以 存储 的 数据 类 型 是 在 表 声 明 时 即 以 确定 的 ， 因 此 它们 之 间 在 数据 存储 方面 还 是 存在 
着 很 大 的 差异 。 在 SQLite 中 ， 存 储 分 类 和 数据 类 型 也 有 一 定 的 差别 ， 如 INTEGER 存 储 类 别 可 
以 包含 6 种 不 同 长 度 的 Integer 数 据 类 型 ， 然 而 这 些 INTEGER 数 据 一 旦 被 读 入 到 内 存 后 ， 
SQLite 会 将 其 全 部 视 为 占用 8 个 字 节 无 符号 整 型 。 因 此 对 于 SQLite 而 言 ， 即 使 在 表 声 明 中 明确 
了 字段 类 型 ， 我 们 仍然 可 以 在 该 字段 中 存储 其 它 类 型 的 数据 。 然 而 需要 特别 说 明 的 是 ， 尽 管 
SQLite 为 我 们 提供 了 这 种 方便 ， 但 是 一 旦 考虑 到 数据 库 平 台 的 可 移植 性 问题 ， 我 们 在 实际 的 
开发 中 还 是 应 该 尽 可 能 的 保证 数据 类 型 的 存储 和 声明 的 一 致 性 。 除 非 你 有 极为 充分 的 理由 ， 
同时 又 不 再 考虑 数据 库 平 台 的 移植 问题 ， 在 此 种 情况 下 确实 可 以 使 用 SQLite 提 供 的 此 种 特 
征 。 


1. 布尔 数据 类 型 : 
SQLite 并 没有 提供 专门 的 布尔 存储 类 型 ， 取 而 代 之 的 是 存储 整 型 1 表示 true，0 表 示 false。 
2. 日 期 和 时 间 数 据 类 型 : 


和 布尔 类 型 一 样 ，SQLite 也 同样 没有 提供 专门 的 日 期 时 间 存 储 类 型 ， 而 是 以 TEXT、REAL 和 
INTEGER 类 型 分 别 不 同 的 格式 表示 该 类 型 ， 如 : 


TEXT: "YYYY-MM-DD HH:MM:SS.SSS" 
REAL: Z4 Julian E 33 4& X, £s fid 


INTEGER: 以 Unix 时 间 形 式 保存 数据 值 ， 即 从 1970-01-01 00:00:00 到 当前 时 间 所 流 经 的 秒 


为 了 最 大 化 SQLite 和 其 它 数 据 库 引擎 之 间 的 数据 类 型 兼容 性 ，SQLite 提 出 了 "类 型 亲缘 性 
(Type Affinity)" 的 概念 。 我 们 可 以 这 样 理解 "类 型 亲缘 性 "， 在 表 字 段 被 声明 之 后 ，SQLite 都 会 
根据 该 字段 声明 时 的 类 型 为 其 选择 一 种 杂 缘 类 型 ， 当 数据 插入 时 ， 该 字段 的 数据 将 会 优先 采 
用 亲缘 类 型 作为 该 值 的 存储 方式 ， 除 非 亲 缘 类 型 不 匹配 或 无 法 转换 当前 数据 到 该 亲缘 类 型 ， 
这 样 SQLite 才 会 考虑 其 它 更 适合 该 值 的 类 型 存储 该 值 。SQLite 目 前 的 版 本 支持 以 下 五 种 亲缘 
类 型 : 


亲缘 类 型 描述 
TEXT 数值 型 数据 在 被 插入 之 前 ， 需 要 先 被 转换 为 文本 格式 ， 之 后 再 插入 到 目标 
字段 中 。 


当 文 本 数据 被 插入 到 亲缘 性 为 NUMERIC 的 字段 中 时 ， 如 果 转 换 操 作 不 会 导 
致 数据 信息 丢失 以 及 完全 可 北 ， 那 么 SQLite 就 会 将 该 文本 数据 转换 为 
INTEGER 或 REAL 类 型 的 数据 ， 如 果 转 换 失 败 ，SQLite 仍 会 以 TEXT 方 式 存 

NUMERIC ” 储 该 数据 。 对 于 NULL 或 BLOB 类 型 的 新 数据 ，SQLite 将 不 做 任何 转换 ， 直 
接 以 NULL 或 BLOB 的 方式 存储 该 数据 。 需 要 额外 说 明 的 是 ， 对 于 浮 点 格式 
的 常量 文本 ， 如 "30000.0"， 如 果 该 值 可 以 转换 为 INTEGER 同 时 又 不 会 丢失 
数值 信息 ， 那 么 SQLite 就 会 将 其 转换 为 INTEGER 的 存储 方式 。 


对 于 杂 缘 类 型 为 INTEGER 的 字段 ， 其 规则 等 同 于 NUMERIC， 唯 一 差别 是 


WIEGER 在 执行 CAST 表 达 式 时 。 

REAL 其 规则 基本 等 同 于 NUMERIC， 唯 一 的 差别 是 不 会 将 "30000.0" 这 样 的 文本 
数据 转换 为 INTEGER 存 储 方式 。 

NONE 不 做 任何 的 转换 ， 直 接 以 该 数据 所 属 的 数据 类 型 进行 存储 。 


1. 决定 字段 亲缘 性 的 规则 : 


字段 的 亲缘 性 是 根据 该 字段 在 声明 时 被 定义 的 类 型 来 决定 的 ， 具 体 的 规则 可 以 参照 以 下 列 
表 。 需 要 注意 的 是 以 下 列表 的 顺序 ， 即 如 果菜 一 字段 类 型 同时 符合 两 种 亲缘 性 ， 那 么 排 在 前 
面 的 规则 将 先 产 生 作用 。 


1). 如 果 类 型 字符 串 中 包含 "INT"， 那 么 该 字段 的 亲缘 类 型 是 INTEGER © 


2). 如 果 类 型 字符 串 中 包含 "CHAR"、"CLOB" 或 "TEXT"， 那 么 该 字段 的 亲缘 类 型 是 TEXT， 如 
VARCHAR ° 


3). 如 果 类 型 字符 囊 中 包含 "BLOB"， 那 么 该 字段 的 亲缘 类 型 是 NONE © 
4). 如 果 类 型 字符 串 中 包含 "REAL"、"FLOA" 或 "DOUB"， 那 么 该 字段 的 亲缘 类 型 是 REAL © 
5). 其 余 情况 下 ， 字 段 的 亲缘 类 型 为 NUMERIC。 


2. 具体 示例 : 


W 
5 
Ao 
y 
Sf 
AX 
ys 


INT INTEGER TINYINT SMALLINT MEDIUMINT BIGINT 


UNSIGNED BIG INT INT2 INT8 INTEGERS |i 
CHARACTER(20) VARCHAR(255) VARYING CHARACTER(255) 

NCHAR(55) NATIVE CHARACTER(70) NVARCHAR(100) TEXT TEXT 2 
CLOB 

BLOB NONE 3 
REAL DOUBLE DOUBLE PRECISION FLOAT REAL 4 
NUMERIC DECIMAL(10,5) BOOLEAN DATE DATETIME NUMERIC 5 


ik: 在 SQLite 中 ， 类 型 VARCHAR(255) 的 长 度 信息 255 没 有 任何 实际 意义 ， 仅 仅 是 为 了 保证 与 
其 它 数据 库 的 声明 一 致 性 。 


三 、 上 比较 表达 式 : 


在 SQLite3 中 支持 的 比较 表达 式 有 E EA E "etm eem. tet ao e "<>" "IN", "NOT IN", 
"BETWEEN", "IS" and "IS NOT" ° 


数据 的 比较 结果 主要 依赖 于 操作 数 的 存储 方式 ， 其 规则 为 : 
1). 存储 方式 为 NULL 的 数值 小 于 其 它 存储 类 型 的 值 。 


2). 存储 方式 为 INTEGER 和 REAL 的 数值 小 于 TEXT 或 BLOB 类 型 的 值 ， 如 果 同 为 INTEGER 或 
REAL， 则 基于 数值 规则 进行 比较 。 


3). 存储 方式 为 TEXT 的 数值 小 于 BLOB 类 型 的 值 ， 如 果 同 为 TEXT， 则 基于 文本 规则 (ASCII 值 ) 
进行 比较 。 

4). 如 果 是 两 个 BLOB 类 型 的 数值 进行 比较 ， 其 结果 为 C 运 行 时 函数 memcmp() 的 结果 。 

四 、 操 作 符 : 


所 有 的 数学 操作 符 (+, -, *, /, %, <<, >>, & and |) 在 执行 之 前 都 会 先 将 操作 数 转 换 为 NUMERIC 
存储 类 型 ， 即 使 在 转换 过 程 中 可 能 会 造成 数据 信息 的 丢失 。 此 外 ， 如 果 其 中 一 个 操作 数 为 
NULL， 那 么 它们 的 结果 亦 为 NULL。 在 数学 操作 符 中 ， 如 果 其 中 一 个 操作 数 看 上 去 并 不 像 数 
值 类 型 ， 那 么 它们 结果 为 0 或 0.0。 


SN 
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善 其 事 ， 必 先 利 其 器 。 学 好 SQLite 的 命令 行 工 具 ， 对 于 我 们 学 习 SQLite 本 身 而 言 是 非常 
TO ae 的 。 最 基本 的 一 条 就 是 ， 它 让 我 们 学 习 SQLite 的 过 程 更 加 轻松 愉快 。 言 归 正 传 
吧 ， 在 SQLite 的 官方 下 载 网 站 ， 提 供 了 支持 多 个 平台 的 命令 行 工具 ， 使 用 et m 
成 大 多 数 常用 的 SQLite 操 作 ， 就 像 sqlplus 之 于 Oracle。 以 下 列表 给 出 了 该 工具 的 内 置 命令 


命令 名 命令 说 明 
.help 列 出 所 有 内 置 命 令 。 
backup 
DBNAME 备份 指定 的 数据 库 到 指定 的 文件 ， 缺 省 为 当前 连接 的 main 数 据 库 。 
FILE 
.databases 列 出 当前 连接 中 所 有 attached 数 据 库 名 和 文件 名 。 
.dump 以 SQL 文本 的 格式 DUMP 当 前 连接 的 main 数 据 库 ， 如 果 指 定 了 表 名 ， 则 
TABLENAME ”只 是 DUMP 和 表 名 匹配 的 数据 表 。 参 数 TABLENAME 支 持 LIKE 表 达 式 支 
持 的 通配符 。 
.echo Vix c RE ee 
ONIOFF 打开 或 关闭 显示 输出 
.exit 退出 当前 程序 。 
.explain 1 å ; 形 3 
ONIOFF 打开 或 关闭 当前 连接 的 SELECT 输出 到 Human Readable 形 式 。 
.header(s) a = eBay » 2S = wl ste o 
ON|OFF 在 显示 SELECT 结果 时 ， 有 是 否 显示 列 的 标题 
.Import FILE "e m pem. 
TABLE 导入 指定 文件 的 数据 到 指定 表 
.indices 显示 所 有 索引 的 名 字 ， 如 果 指 定 表 名 ， 则 仅仅 显示 匹配 该 表 名 的 数据 表 
TABLENAME ”的 索引 ， 参 数 TABLENAME 支 持 LIKE 表 达 式 支持 的 通配符 。 

， 可 以 为 标准 输 ,或 标准 错误 输 
log FILEJoff rs 闭 日 志 功 能 ，FILE 可 以 为 标准 输出 stdout， 或 标准 错误 输出 
SEE 设置 输出 模式 ， 这 里 最 为 常用 的 模式 是 column 模 式 ， 使 SELECT 输出 列 
TABLENAME | =" ER 
.nullvalue 
STRING 使 用 指定 的 字符 串 代 替 NULL 值 的 显 
.Output 1% 4 JT 2 A A 定 a eu 83 o 
SERIE 将 当前 命令 的 所 有 输出 重 定向 到 指定 的 文件 
将 当前 命令 的 所 有 输出 重 定向 到 标准 输出 (屏幕 ) 。 


stdout 


quit 


.read 
FILENAME 


.restore 
DBNAME 
FILE 


.schema 


TABLENAME 


.separator 
STRING 


.show 


.tables 


TABLENAME 


.width NUM1 
NUM2 ... 


见 如 下 常用 示例 : 


退出 当前 程序 。 
执行 指定 文件 内 的 SQL 语句 。 


从 指定 的 文件 还 原 数 据 库 ， 缺 省 为 main 数 据 库 ， 此 时 也 可 以 指定 其 它 数 
据 库 名 ， 被 指定 的 数据 库 成 为 当前 连接 的 attached 数 据 库 。 


显示 数据 表 的 创建 语句 ， 如 果 指 定 表 名 ， 则 仅仅 显示 匹配 该 表 名 的 数据 
表 创 建 语句 ， 参 数 TABLENAME 支 持 LIKE 表 达 式 支持 的 通配符 。 


改变 输出 模式 和 .import 的 字段 间 分 隔 符 。 


显示 各 种 设置 的 当前 值 。 


列 出 当前 连接 中 main 数 据 库 的 所 有 表 名 ， 如 果 指 定 表 名 ， 则 仅仅 显示 匹 
配 该 表 名 的 数据 表 名 称 ， 参 数 TABLENAME 支 持 LIKE 表 达 式 支持 的 通 配 
符 。 


在 MODE 为 column 时 ， 设 置 各 个 字段 的 宽度 ， 注 意 : 该 命令 的 参数 顺序 
表示 字段 输出 的 顺序 。 


1). 备份 和 还 原 数 据 库 。 


-- 在 当前 连接 的 main 数 据 库 中 创建 一 个 数据 表 ， 之 后 再 通过 .backup 命 令 将 main 数 据 库 备份 到 
D:/mydb.db 文 件 中 。 


sqlite> CREATE TABLE mytable (first col integer); 
sqlite> .backup 'D:/mydb.db' 


sqlite> .exit 


-- 通 过 在 命令 行 窗口 下 执行 sqlite3.exe 以 重新 建立 和 SQLite 的 连接 。 


-- 从 备份 文件 D:/mydb.db 中 恢复 数据 到 当前 连接 的 main 数 据 库 中 ， 再 通过 .tables 命 令 可 以 看 到 


mytable 表 。 


sqlite> .restore 'D:/mydb.db' 


sqlite> .tables 


mytable 


2). DUMP 数 据 表 的 创建 语句 到 指定 文件 。 


-- 先 将 命令 行当 前 的 输出 重 定向 到 D:/myoutput.txt， 之 后 在 将 之 前 创建 的 mytable 表 的 声明 语句 


输出 到 该 文件 。 


sqlite> .output D:/myoutput.txt 
sqlite> .dump mytab1% 


sqlite> .exit 


-- 在 DOS 环 境 下 用 记事 本 打开 目标 文件 。 
D:\>notepad myoutput.txt 
3). 显示 当前 连接 的 所 有 Attached 数 据 库 和 main 数 据 库 。 


sqlite> ATTACH DATABASE 'D:/mydb.db' AS mydb; 
sqlite> .databases 


seq name file 
0 main 
2 mydb D:\mydb.db 


4). 显示 main 数 据 库 中 的 所 有 数据 表 。 


sqlite> .tables 
mytable 


5). 显示 匹配 表 名 mytabl% 的 数据 表 的 所 有 索引 。 


sqlite> CREATE INDEX myindex on mytable(first col); 
sqlite> .indices mytabl% 
myindex 


6). 显示 匹配 表 名 mytable% 的 数据 表 的 Schema 信息 。 


-- 依 赖 该 表 的 索引 信息 也 被 输出 。 


sqlite> ,Schema mytabl% 
CREATE TABLE mytable (first col integer); 
CREATE INDEX myindex on mytable(first col); 


T). 格式 化 显示 SELECT 的 输出 信息 。 


-- 插 入 测试 数据 


sqlite> INSERT INTO mytable VALUES(1); 
sqlite> INSERT INTO mytable VALUES(2); 
sqlite> INSERT INTO mytable VALUES(3); 


-- 请 注意 没有 任何 设置 时 SELECT 结果 集 的 输出 格式 。 


sqlite> SELECT * FROM mytable; 
1 
2 
3 


-- 显 示 SELECT 结 果 集 的 列 名 。 


-- 以 列 的 形式 显示 各 个 字段 。 


-- 将 其 后 输出 的 第 一 列 显 示 宽 度 设 置 为 10. 


sqlite> .header on 

sqlite> .mode column 

sqlite> .width 10 

sqlite> SELECT * FROM mytable; 
first col 


SQLite 学 习 手 册 ( 在 线 备份 ) 


、 常 用 备份 : 
下 面 的 方法 是 比较 简单 且 常用 的 SQLite 数 据 库 备份 方式 ， 见 如 下 步骤 : 
1). 使 用 SQLite API 或 Shell 工 具 在 源 数据 库 文件 上 加 共享 锁 。 
2). 使 用 Shell 工 具 (cp 或 copy) 找 贝 数 据 库 文件 到 备份 目录 。 
3). 解除 数据 库 文件 上 的 共享 锁 。 
以 上 3 个 步骤 可 以 应 用 于 大 多 数 场景 ， 而 且 速 度 也 比较 快 ， 然 而 却 存在 一 定 的 刚性 缺陷 ， 如 : 


1). 所 有 打算 在 源 数 据 库 上 执行 写 操作 的 连接 都 不 得 不 被 挂 起 ， 直 到 整个 找 贝 过 程 结 束 并 释放 
文件 共享 锁 。 


2). 不 能 拷贝 数据 到 in-memory 数 据 库 。 


3). 在 拷贝 过 程 中 ， 一 旦 备份 数据 库 所 在 的 主机 出 现任 和 何 突 发 故障 ， 备 份 数据 库 可 能 会 被 破 
坏 o 


eee — 18] TERRE 03 I APIS BA (C 4 v1) > TURF RR REM AKA 


在 的 不 足 。 通 过 该 组 函数 ， 可 以 将 源 数据 库 中 的 内 容 拷 贝 到 另 一 个 数据 库 ， 同 时 覆盖 目标 数 
o 。 整 个 拷贝 过 程 可 以 以 增 量 的 方式 完成 ， 在 此 情况 下 ， ee 需要 在 整 
个 拷贝 过 程 中 都 被 加 锁 ， 而 只 是 在 站 正 读 取 数 据 时 加 共享 锁 。 这 样 ， 其 它 的 用 户 在 访问 源 数 


据 库 时 就 不 会 被 挂 起 。 
、 在 线 备份 APls 简 介 


SQLite 提 供 了 以 下 3 个 APIs 有 函数 用 于 完成 此 操作 ， 这 里 仅仅 给 出 它们 的 基本 用 法 ， 至 于 使 用 细 
节 可 以 参考 SQLite 官 方 网 站 "APls Reference" 
(http://www.sqlite.org/c3ref/backup_finish.html) ° 


1). 函数 sqlite3_backup_init() 用 于 创建 sqlite3_backup 对 象 ， 该 对 象 将 作为 本 次 拷贝 操作 的 句 
柄 传 给 其 余 两 个 函数 。 


2). 函数 sqlite3_backup_step() 用 于 数据 拷贝 ， 如 果 该 函数 的 第 二 个 参数 为 -1， 那 么 整个 拷贝 
过 程 都 将 在 该 函数 的 一 次 调用 中 完成 。 

3). 函数 sqlite3_backup finish() 用 于 释放 sqlite3_backup_init() 函 数 申 请 的 资源 ， 以 避免 资源 泄 
& 。 


在 整个 拷贝 过 程 中 如 果 出 现任 何 错误 ， 我 们 都 可 以 通过 调用 目的 数据 库 连接 的 
sqlite3_errcode() 辑 数 来 获取 具体 的 错误 码 。 此 外 ， 如 果 sqlite3 backup_step() 调 用 失败 ， 由 
于 sqlite3_backup finish() 有 函数 并 不 会 修改 当前 连接 的 错误 码 ， 因 此 我 们 可 以 在 调用 


sglite3 backup finish() 之 后 再 获取 错误 码 ， 从 而 在 代码 中 减少 了 一 次 错误 处 理 。 见 如 下 代码 


示例 (来 自 SQLite 官 网 ) : 
dL fe 
2 This function is used to load the contents of a database file on disk 
3 into the "main" database of open database connection pInMemory, or 
4 to save the current contents of the database opened by pInMemory into 
5 a database file on disk. pInMemory is probably an in-memory database, 
6 but this function will also work fine if it is not. 
7 
8 Parameter zFilename points to a nul-terminated string containing the 
9 name of the database file on disk to load from or save to. If parameter 
10 isSave is non-zero, then the contents of the file zFilename are 
11 overwritten with the contents of the database opened by pInMemory. If 
12 parameter isSave is zero, then the contents of the database opened by 
13 pInMemory are replaced by data loaded from the file zFilename. 
14 
15 If the operation is successful, SQLITE OK is returned. Otherwise, if 
16 an error occurs, an SQLite error code is returned. 
quat 
18 int loadOrSaveDb(sqlite3 *pInMemory, const char *zFilename, int isSave){ 
19 int rc; /* Function return code */ 
20 sqlite3 *pFile; /* Database connection opened on zFilename */ 
21 sqglite3 backup *pBackup; /* Backup object used to copy data */ 
22 sqlite3 *pTo; /* Database to copy to (pFile or pInMemory) */ 
23 sqlite3 *pFrom; /* Database to copy from (pFile or pInMemory) */ 
24 
25 /* Open the database file identified by zFilename. Exit early if this fails 
26 for any reason. */ 
27 rc = sqlite3 open(zFilename, &pFile); 
28  if( rc--SQLITE OK ){ 
29 
30 /* If this is a 'load' operation (isSave--0), then data is copied 
31 from the database file just opened to database pInMemory. 
32 Otherwise, if this is a 'save' operation (isSave--1), then data 
33 is copied from pInMemory to pFile. Set the variables pFrom and 
34 pTo accordingly. */ 
35 pFrom = (isSave ? pInMemory : pFile); 
36 pTo - (isSave ? pFile : pliInMemory); 
37 
38 /* Set up the backup procedure to copy from the "main" database of 
39 connection pFile to the main database of connection pInMemory. 
40 If something goes wrong, pBackup will be set to NULL and an error 
41 code and message left in connection pTo. 
42 
43 If the backup object is successfully created, call backup_step() 
44 to copy data from pFile to pInMemory. Then call backup_finish() 
45 to release resources associated with the pBackup object. If an 
46 error occurred, then an error code and message will be left in 
47 connection pTo. If no error occurred, then the error code belonging 
48 to pTo is set to SQLITE_OK. 
49 */ 
50 pBackup = sqlite3_backup_init(pTo, "main", pFrom, "main"); 
51 if( pBackup ){ 
52 (void)sqlite3 backup step(pBackup, -1); 
53 (void)sqlite3 backup finish(pBackup); 
54 } 
55 rc = sqlite3_errcode(pTo); 
56 } 
57 
58 /* Close the database connection opened on database file zFilename 
59 and return the result of this function. */ 
60 (void)sqlite3 close(pFile); 
61 return rc; 
62 ) 


^ 


高 级 应 用 技巧 : 


在 上 面 的 例子 中 ， 我 们 是 通过 sqlite3_backup_step() 函 数 的 一 次 调用 完成 了 整个 找 贝 过 程 。 该 
实现 方式 仍然 存在 之 前 说 过 的 挂 起 其 它 写 访问 连接 的 问题 ， 为 了 解决 该 问题 ， 这 里 我 们 将 继 
续 介绍 另外 一 种 更 高 级 的 实现 方式 -- 分 片 拷贝， 其 实现 步骤 如 下 : 


1). 函数 sqlite3_backup _init() 用 于 创建 sqlite3_backup 对 象 ， 该 对 象 将 作为 本 次 拷贝 操作 的 多 
柄 传 给 其 余 两 个 函数 。 


2). Bop EE M Rf 用 用 于 拷贝 数据 ， 和 之 前 方法 不 同 的 是 ， 该 函数 的 第 二 个 
参数 不 再 是 -1， 而 是 普通 的 正 整数 ， 表 示 每 次 调用 将 会 捞 贝 的 页 面 数量 ， 如 5。 


3). te RHE A Asqlite3 backup _step() 调 用 结束 后 ， 仍 然 有 更 多 的 页 面 需要 被 描 贝 ， 那 么 我 们 
将 主动 休眠 250ms， 然 后 再 重复 步骤 2). 


4). £X sglite3 backup. finish() 用 于 释放 sqlite3_backup _init() 函 数 申请 的 资源 ， 以 避免 资源 泄 


露 。 


在 上 述 步骤 3) 中 我 们 主动 休眠 250ms， 此 期 间 ， 该 拷贝 操作 不 会 在 源 数据 库 上 持 有 任何 读 锁 ， 
这 样 其 它 的 数据 库 连 接 在 进行 写 操作 时 亦 将 不 会 被 挂 起 。 然 而 在 休眠 期 间 ， 如 果 另 外 一 个 线 
程 或 进程 对 源 数 据 库 进行 了 写 操作 ，SQLite 将 会 检测 到 该 事件 的 发 生 ， 从 而 在 下 一 次 调用 
sqlite3_backup _step() 函 数 时 重新 开始 整个 拷贝 过 程 。 唯 一 的 例外 是 ， 如 果 源 数据 库 不 是 in- 
memory 数 据 库 ， 同 时 写 操作 是 在 与 拷贝 操作 同一 个 进程 内 完成 ， 并 且 在 操作 时 使 用 的 也 是 同 
一 个 数据 库 连 接 句 柄 ， 那 么 目的 数据 库 中 数据 也 将 被 此 操作 同时 自动 修改 。 在 下 一 次 调用 
sqlite3_backup_step() 时 ， 也 将 不 会 有 任何 影响 发 生 。 


事实 上 ， 在 SQLite 中 仍然 提供 了 另外 两 个 辅助 性 函数 backup_remaining() 和 
backup_pagecount()， 其 中 前 者 将 返回 在 当前 备份 操作 中 还 有 多 少 页 面 需要 被 拷贝 ， 而 后 者 
将 返回 本 次 操作 总 共 需 要 找 由 的 页 面 数量 。 显 而 易 见 的 是 ， 通 过 这 两 个 函数 的 返 n 我 
们 可 以 实时 显示 本 次 备份 操作 的 整体 进度 ， 计 算 公式 如 下 : 


Completion = 100% * (pagecount() - remaining()) / pagecount() 


见 以 下 代码 示例 (来 自 SQLite 官 网 ) : 


OONDORWNHE 


62 


ies 

Perform an online backup of database pDb to the database file named 
by zFilename. This function copies 5 database pages from pDb to 
zFilename, then unlocks pDb and sleeps for 250 ms, then repeats the 
process until the entire database is backed up. 


The third argument passed to this function must be a pointer to a progress 
function. After each set of 5 pages is backed up, the progress function 

is invoked with two integer parameters: the number of pages left to 

copy, and the total number of pages in the source file. This information 
may be used, for example, to update a GUI progress bar. 


While this function is running, another thread may use the database pDb, or 
another process may access the underlying database file via a separate 
connection. 


If the backup process is successfully completed, SQLITE_OK is returned. 
Otherwise, if an error occurs, an SQLite error code is returned. 

s7 
int backupDb( 


sqlite3 *pDb, /* Database to back up */ 
const char *zFilename, /* Name of file to back up to */ 
void(*xProgress)(int, int) /* Progress function to invoke */ 
){ 
int rc; /* Function return code */ 
sqlite3 *pFile; /* Database connection opened on zFilename */ 


sqglite3 backup *pBackup; /* Backup handle used to copy data */ 


/* Open the database file identified by zFilename. */ 
rc = sqlite3 open(zFilename, &pFile); 
if( rc--SQLITE OK ){ 


/* Open the sqlite3 backup object used to accomplish the transfer */ 
pBackup - sqlite3 backup init(pFile, "main", pDb, "main"); 
if( pBackup ){ 


/* Each iteration of this loop copies 5 database pages from database 
pDb to the backup database. If the return value of backup step() 
indicates that there are still further pages to copy, sleep for 
250 ms before repeating. */ 


do { 
rc = sqlite3 backup step(pBackup, 5); 
xProgress( 


sqlite3 backup remaining(pBackup), 
sqlite3 backup pagecount(pBackup) 
); 
if( rc--SQLITE OK || rc--SQLITE BUSY || rc--SQLITE LOCKED ){ 
sqlite3_sleep(250); 


} 
} while( rc--SQLITE OK || rc--SQLITE BUSY || rc--SQLITE LOCKED ); 


/* Release resources allocated by backup init(). */ 
(void)sqlite3 backup finish(pBackup); 


rc = sglite3 errcode(pFile); 


j 


/* Close the database connection opened on database file zFilename 
and return the result of this function. */ 

(void)sqlite3 close(pFile); 

return rc; 


} 


SQLite 学 习 手 册 ( 内 存 数据 库 ) 


一 、 内 存 数据 库 : 


在 SQLite 中 ， 数 据 库 通常 是 存储 在 磁盘 文件 中 的 。 然 而 在 有 些 情况 下 ， 我 们 可 以 让 数据 库 始 
终 驻 留 在 内 存 中 。 最 常用 的 一 种 方式 是 在 调用 sqlite3_open() 的 时 候 ， 数 据 库 文件 名 参数 传 
弟 "*memory:"， 如 : 


rc = sqlite3 open(":memory:", &db); 


在 调用 完 以 上 函数 后 ， 不 会 有 任何 磁盘 文件 被 生成 ， 取 而 代 之 的 是 ， 一 个 新 的 数据 库 在 纯 内 

存 中 被 成 功 创建 了 。 由 于 没有 持久 化 ， 该 数据 库 在 当前 数据 库 连接 被 关闭 后 就 会 立刻 消失 。 

需要 注意 的 是 ， 尽 管 多 个 数据 库 连 接 都 可 以 通过 上 面 的 方法 创建 内 存 数据 库 ， 然 而 它们 却 是 

不 同 的 数据 库 ， 相 互 之 间 没 有 任何 关系 。 事 实 上 ， 我 们 也 可 以 通过 Attach 命 令 将 内 存 数据 库 像 
其 他 普通 数据 库 一 样 ， 附 加 到 当前 的 连接 中 ， 如 : 


ATTACH DATABASE ':memory:' AS auxi; 


二 、 临 时 数据 库 : 


在 调用 sqlite3_open() 函 数 或 执行 ATTACH 命 令 时 ， 如 果 数 据 库 文件 参数 传 的 是 空 字符 串 ， 那 
么 一 个 新 的 临时 文件 将 被 创建 作为 临时 数据 库 的 底层 文件 ， 如 : 


rc = sqlite3_open("", &db); 


或 


ATTACH DATABASE '' AS aux2; 


和 内 存 数据 库 非常 相似 ， 两 个 数据 库 连接 创建 的 临时 数据 库 也 是 各 自 独立 的 ， 在 连接 关闭 
后 ， 临 时 数据 库 将 自动 消失 ， 其 底层 文件 也 将 被 自动 删除 。 


尽管 磁盘 文件 被 创建 用 于 存储 临时 数据 库 中 的 数据 信息 ， 但 是 实际 上 临时 数据 库 也 会 和 内 存 
数据 库 一 样 通常 驻 留 在 内 存 中 ， 唯 一 不 同 的 是 ， 当 临时 数据 库 中 数据 量 过 大 时 ，SQLite 为 了 
保证 有 更 多 的 内 存 可 用 于 其 它 操作 ， 因 此 会 将 临时 数据 库 中 的 部 分 数据 写 到 磁盘 文件 中 ， 而 
内 存 数据 库 则 始终 会 将 数据 存放 在 内 存 中 。 


SQLite 学 习 手 册 ( 临 时 文件 ) 


一 、 简 介 : 
SPOOL Sy eee A ， 然 而 事实 上 在 SQLite 运 行 时 却 存 在 着 一 些 隐 含 的 临 
时 文件 ， 这 些 临时 文件 是 出 于 不 同 的 目的 而 存在 的 ， oe ， 它们 是 透明 的 ， 因 此 
在 开发 的 过 程 中 我 们 并 不 需要 关注 它们 的 存在 。 尽 管 如 此 ， 如 果 能 对 这 些 临 时 文件 的 产生 机 
制 和 应 用 场景 有 着 很 好 的 理解 ， 那 么 对 我 们 今后 应 a a A 的 。 在 
SQLite 中 主要 产生 以 下 七 种 临时 文件 ， 如 : 


1). 回 滚 日 志 。 


m 


2) 主 数据 库 日 


m 


o 


3). SQL 语句 日 
A). 临时 数据 库 文件 。 

5). 视图 和 子 查询 的 临时 持久 化 文件 。 

6). 临时 索引 文件 。 

7). VACUUM 命令 使 用 的 临时 数据 库 文件 。 
二 、 有 具体 说 明 : 

1. EE E à: 


SQLite 为 了 保证 事物 的 原子 性 提交 和 回 滚 ， 在 事物 开始 时 创建 了 该 临时 文件 。 此 文件 始终 

于 和 数据 库 文件 相同 的 目录 下 ， 其 文件 名 格式 为 : 数据 库 文件 名 + "-journal"。 换 名 话说 ， 如 果 
没有 该 临时 文件 的 存在 ， 当 程序 运行 的 系统 出 现任 何故 障 时 ，SQLite 将 无 法 保证 事物 的 完整 
性 ， 以 及 数据 状态 的 一 致 性 。 该 文件 在 事物 提交 或 回 滚 后 将 被 立刻 删除 。 


在 事物 运行 期 间 ， 如 果 当 前 主机 因 电 源 故 障 而 宕 机 ， 而 此 时 由 于 回 滚 日 志文 件 已 经 保存 在 磁 
盘 上 ， 那 么 当下 一 次 程序 启动 时 ，SQLite 在 打开 数据 库 文件 的 过 程 中 将 会 发 现 该 临时 文件 的 
存在 ， 我 们 称 这 种 日 志文 件 为 "Hot Journal"。SQLite 会 在 成 功 打开 数据 库 之 前 先 基于 该 文件 完 
成 数据 库 的 恢复 工作 ， 以 保证 数据 库 的 数据 回复 到 上 一 个 事物 开始 之 前 的 状态 。 


在 SQLite 中 我 们 可 以 通过 修改 journal _mode pragma， 而 使 SQLite 对 维护 该 文件 采用 不 同 的 策 
略 。 缺 省 情况 下 该 值 为 DELETE， 即 在 事物 结束 后 删除 日 志文 件 。 而 PERSIST 选 项 值 将 不 会 
删除 日 志文 件 ， 而 是 将 回 滚 日 志文 件 的 头 部 清 零 ， 从 而 避免 了 文件 删除 所 带 的 磁盘 开销 。 再 
有 就 是 OFF 选 项 值 ， 该 值 将 指示 SQLite 在 开始 事物 时 不 产生 回 滚 日 志文 件 ， 这 样 一 旦 出 现 系 
统 故 障 ，SQLite 也 无 法 再 保障 数据 库 数 据 的 一 致 性 。 


2. 主 数据 库 日 志 : 


在 SQLite 中 ， 如 果 事 物 的 操作 作用 于 多 个 数据 库 ， 即 通过 ATTACH 命 令 附 加 到 当前 连接 中 的 数 
据 库 ， 那 么 SQLite 将 生成 主 数据 库 日 志文 件 以 保证 事物 产生 的 改变 在 多 个 数据 库 之 间 保 持原 

子 性 。 和 回 滚 日 志文 件 一 样 ， 主 数据 库 日 志文 件 也 位 于 当前 连接 中 主 数据 库 文 件 所 处 的 目录 
内 ， 其 文件 名 格式 为 : 主 数据 库 文件 名 + 随机 的 后 级 。 在 该 文件 中 ， 将 包含 所 有 当前 事物 将 
会 改变 的 Attached 数 据 库 的 名 字 。 在 事物 被 提交 之 后 ， 此 文件 亦 被 SQLite 随 之 删除 。 


主 数据 库 日 志文 件 只 有 在 某 一 事物 同时 操作 多 个 数据 库 时 ( 主 数据 库 和 Attached 数 据 库 ) 才 有 可 

能 被 创建 。 通 过 该 文件 ，SQLite 可 以 实现 跨 多 个 数据 库 的 事物 原子 性 ， 否 则 ， 只 能 简单 的 保 
证 每 个 单一 的 数据 库 内 的 状态 一 致 性 。 换 和 句 话说 ， 如 果 该 事物 在 执行 的 过 程 中 出 现 系统 崩 汗 
或 主机 宕 机 的 现象 ， 在 进行 数据 恢复 时 ， 若 没有 该 文件 的 存在 ， 将 会 导致 部 分 SQLite 数 据 库 
处 于 提交 状态 ， 而 另外 一 部 分 则 处 于 回 滚 状态 ， 因 此 该 事物 的 一 致 性 将 被 打破 。 


3. SQLi$ $4 H & : 


在 一 个 较 大 的 事物 中 ，SQLite 为 了 保证 部 分 数据 在 出 现 错误 时 可 以 被 正常 回 滚 ， 所 以 在 事物 
开始 时 创建 了 SQL 语 句 日 志文 件 。 比 如 ，Update 语 句 修 改 了 前 50 条 数据 ， 然 而 在 修改 第 51 条 
数据 时 发 现 该 操作 将 会 破坏 某 字 段 的 唯一 性 约束 ， 最 终 SQLite 将 不 得 不 通过 该 日 志文 件 回 滚 
已 经 修改 的 前 50 条 数据 。 


SQL 语 名 日志 文件 只 有 在 INSERT 或 UPDATE 语 句 修改 多 行 记录 时 才 有 可 能 被 创建 ， 与 此 同 
时 ， 这 些 操作 还 极 有 可 能 会 打破 某 些 约束 并 引发 异常 。 但 是 如 果 INSERT 或 UPDATE 语 名 没有 
包含 在 BEGIN...COMMIT 中 ， 同 时 也 没有 任何 其 它 的 SQL 语 TEE 当前 的 连接 上 运行 ， 在 
这 种 情况 下 ，SQLite 将 不 会 创建 SQL 语 名 日志 文件 ， 而 是 简单 的 通过 回 滚 日 志 来 完成 部 分 数 

据 的 UNDO 操 作 。 


和 上 面 两 种 临时 文件 不 同 的 是 ，SQL 语 句 日 志文 件 并 不 一 定 要 存储 在 和 数据 库 文件 相同 的 目 
录 下 ， 其 文件 名 也 是 随机 生成 。 该 文件 所 占用 的 磁盘 空间 需要 视 UPDATE 或 INSERT 语 名 将 要 
修改 的 记录 数量 而 定 。 在 事物 结束 后 ， 该 文件 将 被 自动 删除 。 


4. 临时 数据 库 文 件 : 


当 使 用 "CREATE TEMP TABLE" 语 法 创建 临时 数据 表 时 ， 该 数据 表 仅 在 当前 连接 内 可 见 ， 在 
当前 连接 被 关闭 后 ， 临 时 表 也 随 之 消失 。 然 而 在 生命 期 内 ， 临 时 表 将 连同 其 相关 的 索引 和 视 
图 均 会 被 存储 在 一 个 临时 的 数据 库 文 件 之 内 。 该 临时 文件 是 在 第 一 次 执行 "CREATE TEMP 
TABLE" 时 即 被 创建 的 ， 在 当前 连接 被 关闭 后 ， 该 文件 亦 将 被 自动 删除 。 最 后 需要 说 明 的 是 ， 
临时 数据 库 不 能 被 执行 DETACH 命 令 ， 同 时 也 不 能 被 其 它 进程 执行 ATTACH 命 令 。 


5. 视图 和 子 查 询 的 临时 持久 化 文件 : 


在 很 多 包含 子 查 询 的 查询 中 ，SQLite 的 执行 器 会 将 该 查询 语句 拆 分 为 多 个 独立 的 SQL 语 句 ， 
同时 将 子 查询 的 结果 持久 化 到 临时 文件 中 ， 之 后 在 基于 该 临时 文件 中 的 数据 与 外 部 查询 进行 
关联 ， 因 此 我 们 可 以 称 其 为 物化 子 查询 。 通 常 而 言 ，SQLite 的 优化 器 会 尽力 避免 子 查询 的 物 
化 行为 ， 但 是 在 有 些 时 候 该 操作 是 无 法 避免 的 。 该 临时 文件 所 占用 的 磁盘 空间 需要 依赖 子 查 
询 检 索 出 的 数据 数量 ， 在 查询 结束 后 ， 该 文件 将 被 自动 删除 。 见 如 下 示例 : 


SELECT * FROM ex1 WHERE ex1.a IN (SELECT b FROM ex2); 


在 上 面 的 查询 语句 中 ， 子 查询 SELECT b FROM ex2 的 结果 将 会 被 持久 化 到 临时 文件 中 ， 外 部 
查询 在 运行 时 将 会 为 每 一 条 记录 去 检查 该 临时 文件 ， 以 判断 当前 记录 是 否 出 现在 临时 文件 

中 ， 如 果 是 则 输出 当前 记录 。 显 而 易 见 的 是 ， 以 上 的 行为 将 会 产生 大 量 的 ID 操作 ， 从 而 显著 
的 降低 了 查询 的 执行 效率 ， 为 了 避免 临时 文件 的 生成 ， 我 们 可 以 将 上 面 的 查询 语 负 改 为 : 


SELECT * FROM exi WHERE EXISTS(SELECT 1 FROM ex2 WHERE ex2.b=ex1.a); 
对 于 如 下 查询 语句 ， 如 果 SQLite 不 做 任何 智能 的 rewrite 操 作 ， 该 查询 中 的 子 查询 也 将 会 被 持 
久 化 到 临时 文件 中 ， 如 : 


SELECT * FROM ex1 JOIN (SELECT b FROM ex2) AS t ON t.b=ex1.a; 


在 SQLite 自 动 将 其 修改 为 下 面 的 写法 后 ， 将 不 会 再 生成 临时 文件 了 ， 如 : 


SELECT ex1.*, ex2.b FROM ex1 JOIN ex2 ON ex2.bzex1.a; 


6. 临时 索引 文件 : 

当 查 询 语 名 包含 以 下 SQL 从 名 时 ，SQLite 为 存储 中 间 结 果 而 创建 了 临时 索引 文件 ， 如 : 
1). ORDER BY 或 GROUP BYM 4] ° 

2). 聚集 查询 中 的 DISTINCT 关 键 字 。 

3). &UNION ` EXCEPTA? INTERSECT 4& 44 £ SELECT & i i& 6] o 


需要 说 明 的 是 ， 如 果 在 指定 的 字段 上 已 经 存在 了 索引 ， 那 么 SQLite 将 不 会 再 创建 该 临时 索引 
文件 ， 而 是 通过 直接 遍历 索引 来 访问 数据 并 提取 有 用 信息 。 如 果 没 有 索引 ， 则 需要 将 排序 的 
结果 存储 在 临时 索引 文件 中 以 供 后 用 。 该 临时 文件 所 占用 的 磁盘 空间 需要 依赖 排序 数据 的 数 
量 ， 在 查询 结束 后 ， 该 文件 被 自动 删除 。 

7. VACUUM 命令 使 用 的 临时 数据 库 文件 : 

VACUUM 命令 在 工作 时 将 会 先 创建 一 个 临时 文件 ， 然 后 再 将 重建 的 整个 数据 库 写 入 到 该 临时 
文件 中 。 之 后 再 将 临时 文件 中 的 内 容 拷贝 回 原 有 的 数据 库 文件 中 ， 最 后 删除 该 临时 文件 。 
该 临时 文件 所 占用 的 磁盘 空间 不 会 超过 原 有 文件 的 尺寸 。 

三 、 相 关 的 编译 时 参数 和 指令 : 

对 于 SQLite 来 说 ， 回 滚 日 志 、 主 数据 库 日 志和 SQL 语 多 日 志文 件 在 需要 的 时 候 SQLite 都 会 将 
它们 写 入 磁盘 文件 ， 但 是 对 于 其 它 类 型 的 临时 文件 ，SQLite 是 可 以 将 它们 存放 在 内 存 中 以 取 
代 磁 瘟 文 件 的 ， 这 样 在 执行 的 过 程 中 就 可 以 减少 大 量 的 ID 操作 了 。 要 完成 该 优化 主要 依赖 于 


以 下 三 个 因素 : 

1. 编译 时 参数 SQLITE TEMP. STORE : 

该 参数 是 源 代码 中 的 宏 定 义 (#qdefine)， 其 取 值 范围 是 0 到 3( 缺 省 值 为 1)， 见 如 下 说 明 : 

1). 等 于 0 时 ， 临 时 文件 总 是 存储 在 磁盘 上 ， 而 不 会 考虑 temp_store pragma 指 令 的 设置 。 
2). 等 于 1 时 ， 临 时 文件 缺 省 存储 在 磁盘 上 ， 但 是 该 值 可 以 被 temp_store pragma4ds SR & » 
3). 等 于 2 时 ， 临 时 文件 缺 省 存储 在 内 存 中 ， 但 是 该 值 可 以 被 femp_store pragma +H & © 
4). 等 于 3 时 ， 临 时 文件 总 是 存储 在 内 存 中 ， 而 不 会 考虑 temp_store pragma 指 令 的 设置 。 
2. 运行 时 指令 temp_store pragma : 


该 指令 的 取 值 范围 是 0 到 2( 缺 省 值 为 0)， 在 程序 运行 时 该 指令 可 以 被 动态 的 设置 ， 见 如 下 说 
aA: 


1). 等 于 0 时 ， 临 时 文件 的 存储 行为 完全 由 SQLITE_ TEMP _STORE 编 译 期 参数 确定 。 


2). 等 于 1 时 ， 如 果 编 译 期 参数 SQLITE_TEMP_STORE 指 定 使 用 内 存 存储 临时 文件 ， 那 么 该 指 
令 将 履 盖 这 一 行为 ， 使 用 磁盘 存储 。 


2). 等 于 2 时 ， 如 果 编 译 期 参数 SQLITE_TEMP_STORE 指 定 使 用 磁盘 存储 临时 文件 ， 那 么 该 指 
令 将 覆盖 这 一 行为 ， 使 用 内 存 存 储 。 


3. 临时 文件 的 大 小 : 


对 于 以 上 两 个 参数 ， 都 有 参数 值 表示 缺 省 情况 是 存储 在 内 存 中 的 ， 只 有 当 临 时 文件 的 大 小 超 
过 一 定 的 阅 值 后 才 会 根据 一 定 的 算法 ， 将 部 分 数据 写 入 到 磁盘 中 ， 以 免 临 时 文件 占用 过 多 的 
内 存 而 影响 其 它 程序 的 执行 效率 。 


最 后 在 重新 资 述 一 遍 ，SQLITE_TEMP_STORE 编 译 期 参数 和 temp_store pragma 运 行 时 指令 
只 会 影响 除 回 滚 日 志和 主 数据 库 日 志 之 外 的 其 它 临 时 文件 的 存储 策略 。 换 名 话说 ， 回 滚 日 志 
和 主 数 据 库 日 志 将 总 是 将 数据 写 入 磁盘 ， 而 不 会 关注 以 上 两 个 参数 的 值 。 


四 、 其 它 优化 策略 : 


在 SQLite 中 由 于 采用 了 Page Cache 的 缓冲 优化 机 制 ， 因 此 即便 临时 文件 被 指定 存储 在 磁盘 
上 ， 也 只 有 当 该 文件 的 大 小 增长 到 一 定 的 尺寸 后 才 有 可 能 被 SQLite 刷 新 到 磁盘 文件 上 ， 在 此 
之 前 它们 仍 将 驻 留 在 内 存 中 。 这 就 意味 着 对 于 大 多 数 场景 ， 如 果 临 时 表 和 临时 索引 的 数据 量 
相对 较 少 ， 那 么 它们 是 不 会 被 写 到 磁盘 中 的 ， 当 然 也 就 不 会 有 IO 事件 发 生 。 只 有 当 它 们 增长 
到 内 存 不 能 容纳 的 时 候 才 会 被 刷新 到 磁盘 文件 中 的 。 其 中 
SQLITE_DEFAULT_TEMP_CACHE_SIZE 编 译 期 参数 可 以 用 于 指定 临时 表 和 索引 在 占用 多 少 
Cache Page 时 才 需 要 被 刷新 到 磁盘 文件 ， 该 参数 的 缺 省 值 为 500 页 。 


SQLite ž 3 F AT (£t Fe 2E AE hl) 


一 、 概 述 : 


在 SQLite 中 ， 锁 和 并 发 控制 机 制 都 是 由 pager_ module 模 块 负责 处 理 的 ， 如 ACID(Atomic， 
Consistent, lsolated, and Durable)。 在 含有 数据 修改 的 事务 中 ， 该 模块 将 确保 或 者 所 有 的 数 
据 修 改 全 部 提交 ， 或 者 全 部 回 滚 。 与 此 同时 ， 该 模块 还 提供 了 一 些 磁盘 文件 的 内 存 Cache 功 


事实 上 ，pager_module 模 块 并 不 关心 数据 库存 储 的 细节 ， 如 B-Tree、 编 码 方式 、 索 引 等 ， 它 
只 是 将 其 视 为 由 统一 大 小 (通常 为 1024 字 节 ) 的 数据 块 构成 的 单一 文件 ， 其 中 每 个 块 被 称 为 一 个 
W (page) 。 在 该 模块 中 页 的 起 始 编号 为 1， 即 第 一 个 页 的 索引 值 是 1， 其 后 的 页 编号 以 此 类 

推 。 


二 、 文 件 锁 : 
在 SQLite 的 当前 版 本 中 ， 主 要 提供 了 以 下 五 种 方式 的 文件 锁 状 态 。 
1). UNLOCKED : 


文件 没有 持 有 任何 锁 ， 即 当前 数据 库 不 存在 任何 读 或 写 的 操作 。 其 它 的 进程 可 以 在 该 数据 库 
上 执行 任意 的 读 写 操作 。 此 状态 为 缺 省 状态 。 


2). SHARED : 


在 此 状态 下 ， 该 数据 库 可 以 被 读 取 但 是 不 能 被 写 入 。 在 同一 时 刻 可 以 有 任意 数量 的 进程 在 同 
一 个 数据 库 上 持 有 共享 锁 ， 因 此 读 操 作 是 并 发 的 。 换 名 话说 ， 只 要 有 一 个 或 多 个 共享 锁 处 于 
活动 状态 ， 就 不 再 允许 有 数据 库 文 件 写 入 的 操作 存在 。 


3). RESERVED : 


假如 某 个 进程 在 将 来 的 某 一 时 刻 打算 在 当前 的 数据 库 中 执行 写 操作 ， 然 而 此 时 只 是 从 数据 库 
中 读 取 数据 ， 那 么 我 们 就 可 以 简单 的 理解 为 数据 库 文件 此 时 已 经 拥有 了 保留 锁 。 当 保留 锁 处 
于 活动 状态 时 ， 该 数据 库 只 能 有 一 个 或 多 个 共享 锁 存 在 ， 即 同一 数据 库 的 同一 时 刻 只 能 存在 
一 个 保留 锁 和 多 个 共享 锁 。 在 Oracle 中 此 类 锁 被 称 之 为 预 写 锁 ， 不 同 的 是 Oracle 中 锁 的 粒度 可 
以 细 化 到 表 甚 至 到 行 ， 因 此 该 种 锁 在 Oracle 中 对 并 发 的 影响 程序 不 像 SQLite 中 这 样 大 。 


4). PENDING : 


PENDING 锁 的 意思 是 说 ， 某 个 进程 正 打算 在 该 数据 库 上 执行 写 操作 ， 然 而 此 时 该 数据 库 中 却 
存在 很 多 共享 锁 ( 读 操作 )， 那 么 该 写 操作 就 必须 处 于 等 待 状态 ， 即 等 待 所 有 共享 锁 消 失 为 止 ， 
与 此 同时 ， 新 的 读 操 作 将 不 再 被 允许 ， 以 防止 写 锁 饥 饿 的 现象 发 生 。 在 此 等 待 期 间 ， 该 数据 
库 文件 的 锁 状 态 为 PENDING， 在 等 到 所 有 共享 锁 消 失 以 后 ，PENDING 锁 状态 的 数据 库 文 件 
将 在 获取 排他 锁 之 后 进入 EXCLUSIVE 状 态 。 


5). EXCLUSIVE : 


在 执行 写 操作 之 前 ， 该 进程 必须 先 获 取 该 数据 库 的 排他 锁 。 然 而 一 旦 拥有 了 排他 锁 ， 任 何其 
它 锁 类 型 都 不 能 与 之 共存 。 因 此 ， 为 了 最 大 化 并 发 效率 ，SQLite 将 会 最 小 化 排他 锁 被 持 有 的 


时 间 总 量 。 


最 后 需要 说 明 的 是 ， 和 其 它 关系 型 数据 库 相 比 ， 如 MySQL、Oracle 等 ，SQLite 数 据 库 中 所 有 
的 数据 都 存储 在 同一 文件 中 ， 与 此 同时 ， 它 却 仅仅 提供 了 粗 粒度 的 文件 锁 ， 因 此 ，SQLite 在 
并 发 性 和 伸缩 性 等 方面 和 其 它 关 系 型 数据 库 还 是 无 法 比拟 的 。 由 此 可 见 ，SQLite 有 其 自身 的 
适用 场景 ， 就 如 在 本 系列 开篇 中 所 说 ， 它 和 其 它 关系 型 数据 库 之 间 的 互 换 性 还 是 非常 有 限 
的 。 


三 、 回 滚 日 志 : 


当 一 个 进程 要 改变 数据 库 文件 的 时 候 ， 它 首先 将 未 改变 之 前 的 内 容 记 录 到 回 滚 日 志文 件 中 。 
如 果 SQLite 中 的 某 一 事务 正在 试图 修改 多 个 数据 库 中 的 数据 ， 那 么 此 时 每 一 个 数据 库 都 将 生 
成 一 个 属于 自己 的 回 滚 日 志文 件 ， 用 于 分 别 记录 属于 自己 的 数据 改变 ， 与 此 同时 还 要 生成 一 
个 用 于 协调 多 个 数据 库 操 作 的 主 数据 库 日 志文 件 ， 在 主 数据 库 日 志文 件 中 将 包含 各 个 数据 库 
回 滚 日 志文 件 的 文件 名 ， 在 每 个 回 滚 日 志文 件 中 也 同样 包含 了 主 数据 库 日 志文 件 的 文件 名 信 
息 。 然 而 对 于 无 需 主 数据 库 日 志文 件 的 回 滚 日 志文 件 ， 其 中 也 会 保留 主 数据 库 日 志文 件 的 信 
息 ， 只 是 此 时 该 信息 的 值 为 空 。 


我 们 可 以 将 回 滚 日 志 视 为 "HOT" 日 志文 件 ， 因 为 它 的 存在 就 是 为 了 恢复 数据 库 的 一 致 性 状态 。 
当 菜 一 进程 正在 更 新 数据 库 时 ， 应 用 程序 或 OS 突然 出 演 ， 这 样 更 新 操作 就 不 能 顺利 完成 。 因 
此 我 们 可 以 说 "HOT" 日 志 只 有 在 异常 条 件 下 才 会 生成 ， 如 果 一 切 都 非常 顺利 的 话 ， 该 文件 将 永 
远 不 会 存在 。 


四 、 数 据 写 入 : 


如 果菜 一 进程 要 想 在 数据 库 上 执行 写 操作 ， 那 么 必须 先 获取 共享 锁 ， 在 共享 锁 获 取 之 后 再 获 
取保 留 锁 。 因 为 保留 锁 则 预示 着 在 将 来 茶 一 时 刻 该 进程 将 会 执行 写 操作 ， 所 以 在 同一 时 刻 只 
有 一 个 进程 可 以 持 有 一 把 保留 锁 ， 但 是 其 它 进 程 可 以 继续 持 有 共享 锁 以 完成 数据 读 取 的 操 
作 。 如 果 要 执行 写 操作 的 进程 不 能 获取 保留 锁 ， 那 么 这 将 说 明 另 一 进程 已 经 获取 了 保留 锁 。 
在 此 种 情况 下 ， 写 操作 将 失败 ， 并 立即 返回 SQLITE_BUSY 错 误 。 在 成 功 获取 保留 锁 之 后 ， 该 
写 进 程 将 创建 回 滚 日 志 。 


在 对 任何 数据 作出 改变 之 前 ， 写 进程 会 将 待 修改 页 中 的 原 有 内 容 先行 写 入 回 滚 日 志文 件 中 ， 
然而 ， 这 些 数据 发 生变 化 的 页 起 初 并 不 会 直接 写 入 磁盘 文件 ， 而 是 保留 在 内 存 中 ， 这 样 其 它 
进程 就 可 以 继续 读 取 该 数据 库 中 的 数据 了 。 


或 者 是 因为 内 存 中 的 cache 已 满 ， 或 者 是 应 用 程序 已 经 提交 了 事务 ， 最 终 ， 写 进程 将 数据 更 新 


到 数据 库 文件 中 。 然 而 在 此 之 前 ， 写 进程 必须 确保 没有 其 它 的 进程 正在 读 取 数据 库 ， 同 时 回 
滚 日 志 中 的 数据 确实 被 物理 的 写 入 到 磁盘 文件 中 ， 其 步骤 如 下 : 


1). 确保 所 有 的 回 滚 日 志 数 据 被 物理 的 写 入 磁盘 文件 ， 以 便 在 出 现 系统 崩溃 时 可 以 将 数据 库 恢 
复 到 一 致 的 状态 。 


2). 获取 PENDING 锁 ， 再 获取 排他 锁 ， 如 果 此 时 其 它 的 进程 仍然 持 有 共享 锁 ， 写 入 线程 将 不 
得 不 被 挂 起 并 等 待 直到 那些 共享 锁 消 失 之 后 ， 才 能 进而 得 到 排他 锁 。 


3). 将 内 存 中 持 有 的 修改 页 写 出 到 原 有 的 磁盘 文件 中 。 


如 果 写 入 到 数据 库 文件 的 原因 是 因为 cache 已 满 ， 那 么 写 入 进程 将 不 会 立刻 提交 ， Wace 
HER ane 但 是 在 接 下 来 的 修改 被 写 入 到 数据 库 文 件 之 前 ， 回 滚 日 志 必 须 被 再 一 次 写 
到 磁盘 中 。 还 要 注意 的 是 ， 写 入 进程 获取 到 的 排他 锁 必 须 被 一 直 持 有 ， 直 到 所 有 的 改变 被 提 
交 时 为 止 。 ， 从 数据 第 一 次 被 刷新 到 磁盘 文件 开始 ， 直 到 事务 被 提交 之 前 ， 其 它 
的 进程 不 能 访问 该 数据 库 。 


当 写 入 进程 准备 提交 时 ， 将 遵循 以 下 步骤 : 

4). 获取 排他 锁 ， 同 时 确保 所 有 内 存 中 的 变化 数据 都 被 写 入 到 磁盘 文件 中 。 

5). 将 所 有 数据 库 文件 的 变化 数据 物理 的 写 入 到 磁盘 中 。 

6). 删除 日 志文 件 。 如 果 在 删除 之 前 出 现 系 统 故障 ， 进 程 在 下 一 次 打开 该 数据 库 时 仍 将 基于 该 
HOT 日 志 进 行 恢复 操作 。 因 此 只 有 在 成 功 删 除 日 志文 件 之 后 ， 我 们 才 可 以 认为 该 事务 成 功 完 
成 。 

7). 从 数据 库 文件 中 删除 所 有 的 排他 锁 和 PENDING 锁 。 

一 旦 PENDING 锁 被 释放 ， 其 它 的 进程 就 可 以 开始 再 次 读 取 数据 库 了 。 

如 果 一 个 事务 中 包含 多 个 数据 库 的 修改 ， 那 么 它 的 提交 逻辑 将 更 为 复杂 ， 见 如 下 步骤 : 

4). 确保 每 个 数据 库 文件 都 已 经 持 有 了 排他 锁 和 一 个 有 效 的 日 志文 件 。 


5). 创建 主 数据 库 日 志文 件 ， 同 时 将 每 个 数据 库 的 回 滚 日 志文 件 的 文件 名 写 入 到 该 主 数据 库 日 
志文 件 中 。 


6). 再 将 主 数据 库 日 志文 件 的 文件 名 分 别 写 入 到 每 个 数据 库 回 滚 日 志文 件 的 指定 位 置 中 。 
T). 将 所 有 的 数据 库 变化 持久 化 到 数据 库 磁盘 文件 中 。 


8). 删除 主 日 志文 件 ， 如 果 在 删除 之 前 出 现 系 统 故 障 ， 进 程 在 下 一 次 打开 该 数据 库 时 仍 将 基于 
该 HOT 日 志 进 行 恢复 操作 。 因 此 只 有 在 成 功 删除 主 日 志文 件 之 后 ， 我 们 才 可 以 认为 该 事务 成 
功 完成 。 


9). 删除 每 个 数据 库 各 自 的 日 志文 件 。 


10). 从 所 有 数据 库 中 删除 掉 排 他 锁 和 PENDING 锁 。 


s n eee amy Bela 
终 都 有 读 操作 发 生 ， 即 在 每 一 时 刻 该 数据 库 都 持 有 至 少 一 把 共享 锁 ， 这 样 将 会 导致 没有 
ER ， 因 为 在 数据 库 持 有 读 锁 的 时 候 是 无 法 获取 写 锁 的 ， 我 们 将 这 种 情 
形 称 为 " 写 饥 饿 "。 在 SQLite3 中 ， 通 过 使 用 PENDING 锁 则 有 效 的 避免 了 " 写 饥 钱 " 情 形 的 发 生 。 
当 某 一 进程 持 有 PENDING 锁 时 ， 已 经 存在 的 读 操作 可 以 继续 进行 ， 直 到 其 正常 结束 ， 但 是 新 
的 读 操 作 将 不 会 再 被 SQLite 接 受 ， 所 以 在 已 有 的 读 操 作 全 部 结束 后 ， 持 有 PENDING 锁 的 进程 
就 可 以 被 激活 并 试图 进一步 获取 排他 锁 以 完成 数据 的 修改 操作 。 


五 、SQL 级 别 的 事务 控制 


SQLite3 在 实现 上 确实 针对 锁 和 并 发 控制 做 出 了 一 些 精 巧 的 变化 ， 特 别 是 对 于 事务 这 一 SQL 语 
言 级 别 的 特征 。 在 缺 省 情况 下 ，SQLite3 会 将 所 有 的 SQL 操作 置 于 antocommit 模 式 下 ， 这 样 所 
有 针对 数据 库 的 修改 操作 都 会 在 SQL 命令 执行 结束 后 被 自动 提交 。 在 SQLite 中 ，SQL 命 

令 "BEGIN TRANSACTION" 用 于 显 式 的 声明 一 个 事务 ， 即 其 后 的 SQL 语 句 在 执行 后 都 不 会 自 

动 提 交 ， 而 是 需要 等 到 SQL 命令 "COMMIT" 或 "ROLLBACK" 被 执行 时 ， 才 考虑 提交 还 是 回 滚 。 
由 此 可 以 推断 出 ， 在 BEGIN 命 令 被 执行 后 并 没有 立即 获得 任何 类 型 的 锁 ， 而 是 在 执行 第 一 个 
SELECT 语句 时 才 得 到 一 个 共享 锁 ， 或 者 是 在 执行 第 一 个 DML 语 名 时 才 获 得 一 个 保留 锁 。 至 

于 排 它 锁 ， 只 有 在 数据 从 内 存 写 入 磁盘 时 开始 ， 直 到 事务 提交 或 回 滚 之 前 才能 持 有 排 它 锁 。 


如 果 多 个 SQL 命令 在 同一 个 时 刻 同一 个 数据 库 连 接 中 被 执行 ，autocommit 将 会 被 延迟 执行 ， 
直到 最 后 一 个 命令 完成 。 比 如 ， 如 果 一 个 SELECT 语句 正在 被 执行 ， 在 这 个 命令 执行 期 间 ， 需 
要 返回 所 有 检索 出 来 的 行 记 录 ， 如 果 此 时 处 理 结果 集 的 线程 因为 业务 逻辑 的 需要 被 暂时 挂 起 
并 处 于 等 待 状态 ， 而 其 它 的 线程 此 时 或 许 正在 该 连接 上 对 该 数据 库 执行 INSERT、UPDATE 或 
DELETE 命 令 ， 那 么 所 有 这 些 命 令 作 出 的 数据 修改 都 必须 等 到 SELECT 检 索 结束 后 才能 被 提 
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这 是 该 系列 中 最 后 一 篇 用 方面 的 博客 了 ， 后 面 将 发 布 两 篇 关于 如 何 利用 
SQLije 编 程 的 博客 ， 其 中 还 将 包含 四 个 典型 的 应 用 代码 示例 ， 望 大 家 继续 保持 关注 。 


SQLite 学 习 手 册 ( 实 例 代码 < 一 >) 


一 、 获 取 表 的 Schema 信息 : 


1). 动态 创建 表 。 


2). 根据 sqlite3 提 供 的 API， 获 取 表 字段 的 信息 ， 如 字段 数量 以 及 每 个 字段 的 类 型 。 


3). 删除 该 表 。 


见 以 下 代码 及 关键 性 注释 : 


1 #include <sqlite3.h> 
2 #include <string> 


3 


4 using namespace std; 


5 


6 void doTest() 


Uo 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 


sqlite3* conn = NULL; 
//1\. ATF BEE 
int result = sqlite3_open("D:/mytest.db",&conn); 
if (result != SQLITE_OK) { 
sqlite3_close(conn); 
return; 
} 
const char* createTableSQL = 
"CREATE TABLE TESTTABLE (int col INT, float col REAL, string col TEXT)"; 
sqglite3 stmt* stmt = NULL; 
int len - strlen(createTableSQL); 
//2\， 准 备 创建 数 据 表 ， 如 果 创 建 失败 ， 需 要 用 sqlite3_finalize 释 放 sSqlite3_stmt 对 象 ， 以 防止 内 存 注 
if (sqlite3 prepare v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE OK) { 
if (stmt) 
sqlite3 finalize(stmt); 
sqlite3_close(conn); 
return; 


} 
//3N. 通过 sqlLite3_step 命 令 执行 创建 表 的 语句 。 对 于 DDL 和 DML 语 名 而 言 ，sqlLite3_step 执 行 正确 的 返 E 
// 只 有 SQLITE_DONE， 对 于 SELECT 查询 而 言 ， 如 果 有 数据 返回 SQLITE_ROW， 当 到 达 结 果 集 末尾 时 则 返回 
//SQLITE DONE ° 
if (sqlite3 step(stmt) !- SQLITE DONE) { 

sqlite3_finalize(stmt); 

sqlite3_close(conn); 

return; 


} 
//4\， 释放 创建 表 语 句 对 象 的 资源 。 
sqlite3_finalize(stmt); 
printf("Succeed to create test table now.\n"); 
//5N. 构造 查 询 表 数据 的 Sqlite3_stmt 对 象 。 
const char* selectSQL = "SELECT * FROM TESTTABLE WHERE 1 = 0"; 
sqlite3 stmt* stmt2 = NULL; 
if (sqlite3 prepare v2(conn,selectSQL,strlen(selectSQL),&stmt2,NULL) != SQLITE OK) 
if (stmt2) 
sqlite3 finalize(stmt2); 
sqlite3_close(conn); 
return; 


H 
//6N. 根据 Select 语句 的 对 象 ， 获 取 结 果 集 中 的 字段 数量 。 
int fieldCount = sqlite3 column count(stmt2); 
printf("The column count is %d.\n",fieldCount) ; 
//1\. 遍历 结果 集中 每 个 字段 meta 信 息 ， 并 获取 其 声明 时 的 类 型 。 
for (int i = 0; i < fieldCount; ++i) { 
// 由 于 此 时 Table 中 并 不 存在 数据 ， 再 有 就 是 SQLite 中 的 数据 类 型 本 身 是 动态 的 ， 所 以 在 没有 数据 时 
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} 
int 


{ 


//K& Me sqlite3_column_typeHRRE > »t5Hsglite3 column type X 23E EISQLITE NULL ， 
// 直 到 有 数据 时 才能 返回 具体 的 类 型 ， 因 此 这 里 使 用 了 sq1lite3_colLumn_dec1ltype 函 数 来 获取 表 声 
// 明 时 给 出 的 声明 类 型 。 
string stype = sqlite3 column decltype(stmt2,i); 
stype - strlwr((char*)stype.c str()); 
// 下 面 的 解析 规则 见 该 系列 的 “数据 类 型 - ->1\， 决定 字段 亲缘 性 的 规则 "部 分 ， 其 链接 如 下 : 
/ /http://www.cnblogs.com/stephen-liu74/archive/2012/01/18/2325258.html 
if (stype.find("int") != string::npos) { 
printf("The type of %dth column is INTEGER.\n",i); 
) else if (stype.find("char") !- string::npos 
|| stype.find("text") != string::npos) { 
printf("The type of %dth column is TEXT.\n",i); 
) else if (stype.find("real") != string::npos 
|| stype.find("floa") !- string::npos 
|| stype.find("doub") != string::npos ) { 
printf("The type of %dth column is DOUBLE.n",i); 


sqlite3_finalize(stmt2); 
//8N. 为 了 方便 下 一 次 测试 运行 ， 我 们 这 里 需要 删除 该 函数 创建 的 数据 表 ， 否 则 在 下 次 运行 时 将 无 法 
// 创 建 该 表 ， 因 为 它 已 经 存在 。 
const char* dropSQL = "DROP TABLE TESTTABLE"; 
sqlite3 stmt* stmt3 = NULL; 
if (sqlite3 prepare v2(conn,dropSQL, strlen(dropSQL),&stmt3,NULL) != SQLITE OK) { 
if (stmt3) 
sqlite3 finalize(stmt3); 
sglite3 close(conn); 
return; 


} 
if (sqlite3 step(stmt3) == SQLITE DONE) { 
printf("The test table has been dropped.\n"); 


sqlite3_finalize(stmt3); 
sqlite3_close(conn); 
main() 


doTest(); 
return 0; 


} 

// 输 出 结果 为 : 

//Succeed to create test table now. 
//The column count is 3. 

//The type of Oth column is INTEGER. 
//The type of 1th column is DOUBLE. 
//The type of 2th column is TEXT. 
//The test table has been dropped. 





常规 数据 插入 : 


1). 创建 测试 数据 表 。 


2). 通过 INSERT 语 句 插入 测试 数据 。 


3). 删除 测试 表 。 


见 以 下 代码 及 关键 性 注释 : 


工 
2 
3 
4 
5 
6 


#include <sqlite3.h> 
#include <string> 
#include <stdio.h> 


using namespace std; 


7 void doTest() 


8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 


{ 


j 


sqlite3* conn = NULL; 
//AN.. dE BOE E 
int result = sglite3 open("D:/mytest.db",&conn); 
if (result != SQLITE OK) { 
sqlite3_close(conn); 
return; 
} 
const char* createTableSQL = 
"CREATE TABLE TESTTABLE (int col INT, float col REAL, string col TEXT)"; 
sqglite3 stmt* stmt = NULL; 
int len - strlen(createTableSQL); 
//2\， 准 备 创建 数 据 表 ， 如 果 创 建 失败 ， 需 要 用 sqlite3_finalize 释 放 sSqlite3_stmt 对 象 ， 以 防止 内 存 注 
if (sqlite3 prepare v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE OK) { 
if (stmt) 
sqlite3 finalize(stmt); 
sqlite3_close(conn); 
return; 


} 
//3\， 通 过 sqlite3_step 命 令 执行 创建 表 的 语句 。 对 于 DDL 和 DML 语 句 而 言 ，Sqlite3_step 执 行 正确 的 返 开 
// 只 有 SQLITE_DONE， 对 于 SELECT 查询 而 言 ， 如 果 有 数据 返回 SQLITE_ROW， 当 到 达 结 果 集 末尾 时 则 返回 
//SQLITE DONE ° 
if (sqlite3 step(stmt) != SQLITE DONE) { 

sqlite3_finalize(stmt); 

sqlite3_close(conn); 

return; 


} 

//4\， 释放 创建 表 语句 对 象 的 资源 。 
sqlite3_finalize(stmt); 

printf("Succeed to create test table now.\n"); 


int insertCount = 10; 
//5N. 构建 插入 数据 的 Sqlite3_stmt 对 象 。 
const char* insertSQL = "INSERT INTO TESTTABLE VALUES(%d,%f,'%s')"; 
const char* testString - "this is a test."; 
char sql[1024]; 
sqlite3 stmt* stmt2 = NULL; 
for (int i = 0; i < insertCount; ++i) { 
sprintf(sql,insertSQL,i,i * 1.0,testString); 
if (sqlite3_prepare_v2(conn,sql,strlen(sql),&stmt2,NULL) != SQLITE OK) { 
if (stmt2) 
sqlite3_finalize(stmt2); 
sqlite3_close(conn); 
return; 


H 

if (sqlite3 step(stmt2) != SQLITE DONE) { 
sqlite3 finalize(stmt2); 
sqlite3 close(conn); 
return; 


printf("Insert Succeed.\n"); 


sqlite3_finalize(stmt2); 
//6N. 为 了 方便 下 一 次 测试 运行 ， 我 们 这 里 需要 删除 该 函数 创建 的 数据 表 ， 否 则 在 下 次 运行 时 将 无 法 
// 创 建 该 表 ， 因 为 它 已 经 存在 。 
const char* dropSQL = "DROP TABLE TESTTABLE"; 
sqlite3 stmt* stmt3 = NULL; 
if (sqlite3 prepare v2(conn,dropSQL, strlen(dropSQL),&stmt3,NULL) != SQLITE OK) { 
if (stmt3) 
sqlite3 finalize(stmt3); 
sqlite3_close(conn); 
return; 


} 
if (sqlite3 step(stmt3) == SQLITE DONE) { 
printf("The test table has been dropped.*n"); 


sqlite3_finalize(stmt3); 
sqlite3_close(conn); 


78 int main() 


79 { 


80 doTest(); 
81 return 0; 
82 } 


83 // 输 出 结果 如 下 : 

84 //Succeed to create test table now. 
85 //Insert Succeed. 

86 //Insert Succeed. 

87 //Insert Succeed. 

88 //Insert Succeed. 

89 //Insert Succeed. 

90 //Insert Succeed. 

91 //Insert Succeed. 

92 //Insert Succeed. 

93 //Insert Succeed. 

94 //Insert Succeed. 

95 //The test table has been dropped. 


[E E mE 





SQLite 学 习 手 册 ( 实 例 代码 < 二 >) 


三 、 高 效 的 批量 数据 插入 : 


在 给 出 操作 步骤 之 前 先 简单 说 明 一 下 批量 插入 的 概念 ， 以 帮助 大 家 阅读 其 后 的 示例 代码 。 事 
实 上 ， 批 量 插入 并 不 是 什么 新 的 概念 ， 在 其 它 关系 型 数据 库 的 C 接 口 API 中 都 提供 了 一 定 的 支 
持 ， 只 是 接口 的 实现 方式 不 同 而 已 。 纵 观众 多 流行 的 数据 库 接口 ， 如 OCI(Oracle API) ` 
MySQL API 和 PostgreSQL API 等 ，OCI 提 供 的 编程 接口 最 为 方便 ， 实 现 方式 也 最 为 高 效 。 
SQLite 作 为 一 种 简单 灵活 的 谋 入 式 数 据 库 也 同样 提供 了 该 功能 ， 但 是 实现 方式 并 不 像 其 他 数 
据 库 那样 方便 明显 ， 它 只 是 通过 一 种 隐 含 的 技巧 来 达到 批量 插入 的 目的 ， 其 逻辑 如 下 : 


1). 开始 一 个 事物 ， 以 保证 后 面 的 数据 操作 语句 均 在 该 事物 内 完成 。 在 SQLite 中 ， 如 果 没 有 手 
工 开启 一 个 事物 ， 其 所 有 的 DML 语 句 都 是 在 自动 提交 模式 下 工作 的 ， 既 每 次 操作 后 数据 均 被 

自动 提交 并 写 入 磁盘 文件 。 然 而 在 非 自动 提交 模式 下 ， 只 有 当 其 所 在 的 事物 被 手工 COMMIT 
之 后 才 会 将 修改 的 数据 写 入 到 磁盘 中 ， 之 前 修改 的 数据 都 是 仅仅 驻 留 在 内 存 中 。 显 而 易 见 
这 样 的 批量 写 入 方式 在 效率 上 势必 会 远 远 优 于 多 选 代 式 的 单 次 写 入 操作 。 


2). 基于 变量 绑 定 的 方式 准备 待 插入 的 数据 ， 这 样 可 以 节省 大 量 的 sqlite3_prepare_v2 函 数 调 
用 次 数 ， 从 而 节省 了 多 次 将 同一 SQL 语句 编译 成 SQLite 内 部 识别 的 字 节 码 所 用 的 时 间 。 事 实 
上 ，SQLite 的 官方 文档 中 已 经 明确 指出 ， 在 很 多 时 候 sqlite3_prepare_Vv2 函 数 的 执行 时 间 要 多 
Tsqlite3 step BAA utr Ep IR] > EL UE BUS 7E 2p US SH S E ZA A sqite3 prepare v2: 
数 。 在 我 们 的 实现 中 ， 如 果 想 避免 此 类 开销 ， 只 需 将 待 插入 的 数据 以 变量 的 形式 绑 定 到 SQL 
语句 中 ， 这 样 该 SQL 语 句 仅 需 调 用 sqlite3_prepare_v2 兄 数 编译 一 次 即 可 ， 其 后 的 操作 只 是 蔡 
换 不 同 的 变量 数值 。 


3). 在 完成 所 有 的 数据 插入 后 显 式 的 提交 事物 。 提 交 后 ，SQLite 会 将 当前 连接 自动 恢复 为 自动 
提交 模式 。 


下 面 是 示例 代码 的 实现 步 又 : 


1). 创建 测试 数据 表 。 


N 
~ 


通过 执行 BEGIN TRANSACTION 语 名 手工 开局 一 个 事物 。 
3). 准备 插入 语句 及 相关 的 绑 定 变量 。 

4). 迭代 式 插入 数据 。 

5). 完成 后 通过 执行 COMMIT 语 名 提交 事物 。 


. 删除 测试 表 。 


O 
— 


见 以 下 代码 及 关键 性 注释 : 


1 #include <sqlite3.h> 


2 #include <string> 
3 #include <stdio.h> 


4 
5 using namespace std; 
6 
7 void doTest() 
8 { 
9 sqlite3* conn = NULL; 
10 //AN. 打开 数据 库 
11 int result = sqlite3_open("D:/mytest.db",&conn); 
12 if (result != SQLITE OK) { 
13 sqlite3_close(conn); 
14 return; 
15 } 
16 const char* createTableSQL = 
17 "CREATE TABLE TESTTABLE (int_col INT, float_col REAL, string_col TEXT)"; 
18 sqlite3_stmt* stmt = NULL; 
19 int len = strlen(createTableSQL) ; 
20 //2N. 准备 创建 数据 表 ， 如 果 创 建 失败 ， 需 要 用 sqlite3_finalize 释 放 sqlite3_stmt 对 象 ， 以 防止 内 存 
21 if (sqlite3 prepare v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE OK) { 
22 if (stmt) 
23 sqlite3_finalize(stmt); 
24 sqlite3_close(conn); 
25 return; 
26 } 
27 //3N. 通过 sqlite3_step 命 令 执行 创建 表 的 语句 。 对 于 DDL 和 DML 语 名 而 言 ，Sqlite3_step 执 行 正确 的 返 
28 // 只 有 SQLITE_DONE， 对 于 SELECT 查 询 而 言 ， 如 果 有 数据 返回 SQLITE_ROW， 当 到 达 结 果 集 末尾 时 则 返回 
29 //SQLITE_DONE ° 
30 if (sqlite3_step(stmt) != SQLITE_DONE) { 
31 sqlite3_finalize(stmt); 
32 sqlite3_close(conn); 
33 return; 
34 } 
35 //4\. 释放 创建 表 语句 对 象 的 资源 。 
36 sqlite3 finalize(stmt); 
37 printf("Succeed to create test table now.\n"); 
38 
39 //5\， 显 式 的 开启 一 个 事物 。 
40 sqlite3 stmt* stmt2 = NULL; 
41 const char* beginSQL - "BEGIN TRANSACTION"; 
42 if (sqlite3 prepare v2(conn,beginSQL,strlen(beginSQL),&stmt2,NULL) != SQLITE OK) 
43 if (stmt2) 
44 sqlite3_finalize(stmt2); 
45 sqlite3_close(conn); 
46 return; 
47 } 
48 if (sqlite3_step(stmt2) != SQLITE_DONE) { 
49 sqlite3_finalize(stmt2); 
50 sqlite3_close(conn); 
51 return; 
52 } 
53 sqlite3_finalize(stmt2); 
54 
55 //6\. 构建 基于 绑 定 变量 的 插入 数据 。 
56 const char* insertSQL = "INSERT INTO TESTTABLE VALUES(?,?,?)"; 
57 sqlite3 stmt* stmt3 - NULL; 
58 if (sqlite3 prepare v2(conn,insertSQL,strlen(insertSQL),&stmt3,NULL) !- SQLITE OK 
59 if (stmt3) 
60 sqlite3_finalize(stmt3); 
61 sqlite3_close(conn); 
62 return; 
63 } 
64 int insertCount = 10; 
65 const char* strData = "This is a test."; 
66 //TN. 基于 已 有 的 SQL 语句 ， 和 迭代 的 绑 定 不 同 的 变量 数据 
67 for (int i = 0; i < insertCount; ++i) { 
68 // 在 绑 定 时 ， 最 左面 的 变量 索引 值 是 1。 
69 sqlite3 bind int(stmt3,1,1i); 
70 sqlite3 bind double(stmt3,2,i * 1.0); 
71 sqlite3_bind_text(stmt3,3,strData,strlen(strData),SQLITE_TRANSIENT); 
72 if (sqlite3_step(stmt3) != SQLITE_DONE) { 


73 sqlite3_finalize(stmt3); 





74 sqlite3_close(conn); 

75 return; 

76 } 

77 // 重 新 初始 化 该 Sqlite3_stmt 对 象 绑 定 的 变量 。 
78 sqlite3_reset(stmt3); 

79 printf("Insert Succeed.\n"); 

80 } 

81 sqlite3 finalize(stmt3); 

82 

83 //8N. 提交 之 前 的 事物 。 

84 const char* commitSQL = "COMMIT"; 

85 sqlite3 stmt* stmt4 - NULL; 

86 if (sqlite3 prepare v2(conn,commitSQL,strlen(commitSQL),&stmt4,NULL) != SQLITE OK 
87 if (stmt4) 

88 sqlite3_finalize(stmt4); 

89 sqlite3_close(conn); 

90 return; 

91 } 

92 if (sqlite3_step(stmt4) != SQLITE_DONE) { 
93 sqlite3_finalize(stmt4); 

94 sqlite3_close(conn); 

95 return; 

96 } 

97 sqlite3_finalize(stmt4); 

98 

99 //9N. 为 了 方便 下 一 次 测试 运行 ， 我 们 这 里 需要 删除 该 函数 创建 的 数据 表 ， 否 则 在 下 次 运行 时 将 无 法 
100 // 创 建 该 表 ， 因 为 它 已 经 存在 。 

101 const char* dropSQL - "DROP TABLE TESTTABLE"; 
102 sqlite3 stmt* stmt5 = NULL; 

103 if (sqlite3 prepare v2(conn,dropSQL, strlen(dropSQL),&stmt5,NULL) != SQLITE OK) { 
104 if (stmt5) 

105 sqlite3_finalize(stmt5); 

106 sqlite3_close(conn); 

107 return; 

108 } 

109 if (sqlite3 step(stmt5) == SQLITE DONE) { 
110 printf("The test table has been dropped.\n"); 
111 } 

112 sqlite3_finalize(stmt5); 

113 sqlite3_close(conn); 

114 } 

115 

116 int main() 

117 { 

118 doTest(); 

119 return 0; 

120 } 

121 // 输 出 结果 如 下 : 

122 //Succeed to create test table now. 

123 //Insert Succeed. 

124 //Insert Succeed. 

125 //Insert Succeed. 

126 //Insert Succeed. 

127 //Insert Succeed. 

128 //Insert Succeed. 

129 //Insert Succeed. 

130 //Insert Succeed. 

131 //Insert Succeed. 

132 //Insert Succeed. 

133 //The test table has been dropped. 


EEE) 





该 结果 和 上 一 个 例子 (普通 数据 插入 ) 的 结果 完全 相同 ， 只 是 在 执行 效率 上 明显 优 于 前 者 。 


四 、 数 据 查 询 : 


数据 查询 是 每 个 关系 型 数据 库 都 会 提供 的 最 基本 功能 ， 下 面 的 代码 示例 将 给 出 如 何 通过 
SQLite API 获 取 数 据 。 


1). 创建 测试 数据 表 。 


2). 插入 一 条 测试 数据 到 该 数据 表 以 便于 后 面 的 查询 。 


3). 执行 SELECT 语 句 检 索 数据 。 


4). 删除 测试 表 。 


见 以 下 示例 代码 和 关键 性 注释 : 


1 #include <sqlite3.h> 
2 #include <string> 
3 #include <stdio.h> 


4 


5 using namespace std; 


6 


7 void doTest() 


8 { 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 


sqlite3* conn - NULL; 
//AN.. aT RE E 
int result = sqlite3_open("D:/mytest.db",&conn); 
if (result != SQLITE_OK) { 
sqlite3_close(conn); 
return; 
} 
const char* createTableSQL = 
"CREATE TABLE TESTTABLE (int col INT, float col REAL, string col TEXT)"; 
sqlite3 stmt* stmt = NULL; 
int len - strlen(createTableSQL); 
//2N. 准备 创建 数据 表 ， 如 果 创 建 失败 ， 需 要 用 sqlite3_finalize 释 放 sqlite3_stmt 对 象 ， 以 防止 内 存 
if (sqlite3 prepare v2(conn,createTableSQL,len,&stmt,NULL) != SQLITE OK) { 
if (stmt) 
sqlite3_finalize(stmt); 
sqlite3_close(conn); 
return; 


} 
//3N. 通过 sqlite3_step 命 令 执行 创建 表 的 语句 。 对 于 DDL 和 DML 语 名 而 言 ，Sqlite3_step 执 行 正确 的 返 
// 只 有 SQLITE_DONE， 对 于 SELECT 查询 而 言 ， 如 果 有 数据 返回 SQLITE_ROW， 当 到 达 结 果 集 末尾 时 则 返回 
//SQLITE_DONE ° 
if (sqlite3_step(stmt) != SQLITE_DONE) { 

sqlite3_finalize(stmt); 

sqlite3_close(conn); 

return; 


} 

//4N.. 释放 创建 表 语句 对 象 的 资源 。 

sqlite3 finalize(stmt); 

printf("Succeed to create test table now.\n"); 


//5N.. 为 后 面 的 查询 操作 插入 测试 数据 。 
sqlite3 stmt* stmt2 = NULL; 
const char* insertSQL - "INSERT INTO TESTTABLE VALUES(20,21.0,'this is a test.')" 
if (sqlite3 prepare v2(conn,insertSQL,strlen(insertSQL),&stmt2,NULL) !- SQLITE OK 
if (stmt2) 
sqlite3_finalize(stmt2); 
sqlite3_close(conn); 
return; 


} 

if (sqlite3 step(stmt2) != SQLITE DONE) { 
sqlite3_finalize(stmt2); 
sqlite3_close(conn); 
return; 


printf("Succeed to insert test data.\n"); 
sqlite3_finalize(stmt2); 


//6N. 执行 SELECT 语句 查询 数据 。 
const char* selectSQL = "SELECT * FROM TESTTABLE"; 
sqlite3 stmt* stmt3 - NULL; 


59 if (sqlite3 prepare v2(conn,selectSQL,strlen(selectSQL),&stmt3,NULL) !- SQLITE OK 
60 if (stmt3) 
61 sqlite3_finalize(stmt3); 
62 sqlite3_close(conn); 
63 return; 
64 
65 int fieldCount = sqlite3 column count(stmt3); 
66 do { 
67 int r = sglite3 step(stmt3); 
68 if (r == SQLITE ROW) { 
69 for (int i = 0; i < fieldCount; ++i) { 
70 // 这 里 需要 先 判断 当前 记录 当前 字段 的 类 型 ， 再 根据 返回 的 类 型 使 用 不 同 的 API 函 数 
71 // 获 取 实 际 的 数据 值 。 
72 int vtype = sqlite3 column type(stmt3,i); 
73 if (vtype == SQLITE INTEGER) { 
74 int v = sglite3 column int(stmt3,i); 
75 printf("The INTEGER value is %d.\n",v); 
76 ) else if (vtype == SQLITE FLOAT) { 
77 double v = sqlite3_column_double(stmt3,i); 
78 printf("The DOUBLE value is %f.\n",v); 
79 ) else if (vtype == SQLITE TEXT) { 
80 const char* v = (const char*)sqlite3 column text(stmt3,i); 
81 printf("The TEXT value is %s.\n",v); 
82 ) else if (vtype == SQLITE NULL) { 
83 printf("This value is NULL.\n"); 
84 } 
85 } 
86 } else if (r == SQLITE_DONE) { 
87 printf("Select Finished.\n"); 
88 break; 
89 ) else { 
90 printf("Failed to SELECT. n"); 
91 sqlite3_finalize(stmt3); 
92 sqlite3_close(conn); 
93 return; 
94 
95 } while (true); 
96 sqlite3_finalize(stmt3); 
97 
98 J/1\. 为 了 方便 下 一 次 测试 运行 ， 我 们 这 里 需要 删除 该 函数 创建 的 数据 表 ， 否 则 在 下 次 运行 时 将 无 法 
99 // 创 建 该 表 ， 因 为 它 已 经 存在 。 
100 const char* dropSQL = "DROP TABLE TESTTABLE"; 
101 sqlite3 stmt* stmt4 - NULL; 
102 if (sqlite3 prepare v2(conn,dropSQL, strlen(dropSQL),&stmt4,NULL) != SQLITE OK) { 
103 if (stmt4) 
104 sqlite3_finalize(stmt4); 
105 sqlite3_close(conn); 
106 return; 
107 } 
108 if (sqlite3_step(stmt4) == SQLITE_DONE) { 
109 printf("The test table has been dropped.\n"); 
110 } 
111 sqlite3_finalize(stmt4); 
112 sqlite3_close(conn); 
113 } 
114 
115 int main() 
116 { 
117 doTest(); 
118 return 0; 
119 ) 
120 // 输 出 结果 如 下 : 
121 //Succeed to create test table now. 
122 //Succeed to insert test data. 
123 //The INTEGER value is 20. 
124 //The DOUBLE value is 21.000000. 
125 //The TEXT value is this is a test.. 
126 //Select Finished. 
127 //The test table has been dropped. 








